Azure Translator in Foundry Tools v3.0

有什麼新鮮事？

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

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

基底 URL

大多數情況下，轉譯器的請求會由離請求來源最近的資料中心處理。 如果使用全域端點時發生數據中心失敗，要求可能會路由傳送到地理位置之外。

若要強制在特定地理位置內處理要求，請使用所需的地理端點。 所有要求都會在地理位置內的數據中心之間處理。

✔️ 功能：翻譯工具文字

瑞士服務端點

資源位於瑞士北部或瑞士西部的客戶，可確保在瑞士內提供其文字 API 要求。 為確保在瑞士處理要求，請在 Resource regionSwitzerland North 或 Switzerland West 中建立翻譯工具資源，然後在您的 API 要求中使用資源的自訂端點。

例如：如果您在 Azure 入口網站中建立 Resource region 為 Switzerland North 的翻譯工具資源，而且您的資源名稱是 my-swiss-n，則您的自訂端點為 https​://my-swiss-n.cognitiveservices.azure.com。 要轉譯的範例要求是：

// Pass secret key and region using headers to a custom endpoint
curl -X POST "https://my-swiss-n.cognitiveservices.azure.com/translator/text/v3.0/translate?to=fr" \
-H "Ocp-Apim-Subscription-Key: xxx" \
-H "Ocp-Apim-Subscription-Region: switzerlandnorth" \
-H "Content-Type: application/json" \
-d "[{'Text':'Hello'}]" -v

自訂翻譯工具目前不適用於瑞士。

虛擬網路支援

Translator 現已在 Azure 公共雲的所有區域提供虛擬網路（Virtual Network）VNET功能。 要啟用虛擬網路， 請參見配置 Foundry 工具虛擬網路。

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

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

1. 在 Azure 入口網站中瀏覽至您的翻譯工具資源。

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

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

   

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

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

6. 選取 [虛擬網络] 索引標籤 。

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

   

以下是使用自定義端點呼叫翻譯工具的範例要求

// 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?'}]"

指標

計量可讓您在 Azure 入口網站中檢視翻譯工具的使用方式和可用性資訊。 如需詳細資訊，請參閱 數據和平臺計量。

下表列出可用的計量，其中說明如何使用這些計量來監視翻譯 API 呼叫。