有什麼新鮮事?
翻譯工具 3.0 版提供新式 JSON 型 Web API。 它藉由將現有的功能合併成較少的作業,以提供新功能,藉此改善可用性和效能。
- 音譯,以一種語言將文字從一個腳本轉換成另一個腳本。
- 在一個要求中翻譯至多種語言。
- 一個要求中的語言偵測、翻譯和音譯。
- 查詢字詞替代翻譯的字典,以尋找反向翻譯和範例,其中顯示內容中使用的詞彙。
- 更具資訊性的語言偵測結果。
基本 URL
全域基本網址為 https://api.cognitive.microsofttranslator.com。 文字翻譯同時支援地理及資源特定端點。 關於所有端點網址及其請求處理位置,請參見 Azure 翻譯工具 的區域支援。
虛擬網路 支援
該轉譯器現已在Azure公共雲的所有區域提供虛擬網路(VNET)功能。 啟用 虛擬網路 請參見配置 Foundry Tools 虛擬網路。
開啟這項功能之後,您必須使用自定義端點來呼叫翻譯工具。 您無法使用全域翻譯工具端點 (“api.cognitive.microsofttranslator.com”),且無法使用存取令牌進行驗證。
您可以在建立 翻譯工具資源 並允許從選取的網路和私人端點存取之後,找到自定義端點。
在 Azure 入口網站中導航到你的翻譯資源。
從 [資源管理] 區段中選取 [網路]。
在 [防火牆與虛擬網路] 索引標籤下,選擇 [選取的網路與私人端點]。
選取 [儲存] 以套用變更。
從 [資源管理] 區段選取 [金鑰和端點]。
選擇虛擬網路分頁。
列出文字翻譯和文件翻譯的端點。
| 標題 | Description |
|---|---|
| Ocp-Apim-Subscription-Key | 這個價值是你訂閱 Translator 的 Azure 秘密金鑰。 |
| Ocp-Apim-Subscription-Region | 此值是翻譯工具資源的區域。 如果資源為 ,這個值是選擇性的 global |
以下是使用自定義端點呼叫翻譯工具的範例要求
// Pass secret key and region using headers
curl -X POST "https://<your-custom-domain>.cognitiveservices.azure.com/translator/text/v3.0/translate?api-version=3.0&to=es" \
-H "Ocp-Apim-Subscription-Key:<your-key>" \
-H "Ocp-Apim-Subscription-Region:<your-region>" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello, what is your name?'}]"
Metrics
指標功能允許您在 Azure 入口網站中查看翻譯器的使用情況與可用性資訊。 如需詳細資訊,請參閱 數據和平臺計量。
下表列出可用的計量,其中說明如何使用這些計量來監視翻譯 API 呼叫。
| Metrics | Description |
|---|---|
| TotalCalls | API 呼叫總數。 |
| TotalTokenCalls | 使用驗證令牌透過令牌服務呼叫的 API 呼叫總數。 |
| SuccessfulCalls | 成功的呼叫數。 |
| TotalErrors | 具有錯誤回應的呼叫數目。 |
| BlockedCalls | 超過速率或配額限制的呼叫數目。 |
| ServerErrors | 伺服器內部錯誤(5XX) 的呼叫數目。 |
| ClientErrors | 用戶端錯誤 (4XX) 的呼叫數目。 |
| Latency | 以毫秒為單位完成要求的持續時間。 |
| CharactersTranslated | 傳入文字要求中的字元總數。 |