Azure 翻譯工具 in Foundry Tools v3.0

有什麼新鮮事?

翻譯工具 3.0 版提供新式 JSON 型 Web API。 它藉由將現有的功能合併成較少的作業,以提供新功能,藉此改善可用性和效能。

  • 音譯,以一種語言將文字從一個腳本轉換成另一個腳本。
  • 在一個要求中翻譯至多種語言。
  • 一個要求中的語言偵測、翻譯和音譯。
  • 查詢字詞替代翻譯的字典,以尋找反向翻譯和範例,其中顯示內容中使用的詞彙。
  • 更具資訊性的語言偵測結果。

基本 URL

全域基本網址為 https://api.cognitive.microsofttranslator.com。 文字翻譯同時支援地理及資源特定端點。 關於所有端點網址及其請求處理位置,請參見 Azure 翻譯工具 的區域支援。

虛擬網路 支援

該轉譯器現已在Azure公共雲的所有區域提供虛擬網路(VNET)功能。 啟用 虛擬網路 請參見配置 Foundry Tools 虛擬網路。

開啟這項功能之後,您必須使用自定義端點來呼叫翻譯工具。 您無法使用全域翻譯工具端點 (“api.cognitive.microsofttranslator.com”),且無法使用存取令牌進行驗證。

您可以在建立 翻譯工具資源 並允許從選取的網路和私人端點存取之後,找到自定義端點。

  1. 在 Azure 入口網站中導航到你的翻譯資源。

  2. 從 [資源管理] 區段中選取 [網路]。

  3. 在 [防火牆與虛擬網路] 索引標籤下,選擇 [選取的網路與私人端點]。

    Azure入口網站虛擬網路設定的截圖。

  4. 選取 [儲存] 以套用變更。

  5. 從 [資源管理] 區段選取 [金鑰和端點]。

  6. 選擇虛擬網路分頁。

  7. 列出文字翻譯和文件翻譯的端點。

    虛擬網路端點的螢幕快照。

標題 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 傳入文字要求中的字元總數。