什麼是 Azure 文字翻譯？

發行項
10/16/2024

Azure 文字翻譯是翻譯工具服務的雲端式 REST API 功能，其使用類神經機器翻譯技術，在所有支援的語言中即時提供快速且正確的來源到目標文字翻譯。在此概觀中，您會了解文字翻譯 REST API 如何讓您為應用程式和工作流程建置智慧型解決方案。

文字翻譯文件包含下列文章類型：

快速入門。引導您完成對服務提出要求的入門指示。
操作指南。 以更具體或自訂方式存取和使用服務的指示。
參考文章。 REST API 文件和程式設計語言型內容。

文字翻譯功能

文字翻譯支援下列方法：

語言。傳回翻譯、音譯和字典查閱作業所支援的語言清單。此要求不需要驗證；只要將下列 GET 要求複製並貼到您慣用的 REST API 工具或瀏覽器中即可：
```
https://api.cognitive.microsofttranslator.com/languages?api-version=3.0
```
翻譯。使用單一要求，將單一來來源語言文字翻譯為多個目標語言文字。
音譯。將來源語言的字元或字母轉換成目標語言的對應字元或字母。
偵測。傳回原始程式碼語言代碼和布林值變數，指出是否支援文字翻譯和音譯所偵測到的語言。

注意

您可以使用單一 REST API 呼叫，翻譯、音譯及偵測文字。
字典查閱。傳回來源詞彙的目標語言對等字組。
字典範例可傳回來源詞彙和目標詞彙配對的文法結構和內容範例。

文字翻譯部署選項

使用下列資源，將文字翻譯新增至您的專案和應用程式：

透過 Azure 提供的 REST API，存取雲端式翻譯工具服務。
搭配使用 REST API 翻譯要求和文字翻譯 Docker 容器。
重要
- 若要使用翻譯工具容器，您必須完成並提交 Azure AI 服務應用程式有限服務線上要求表單，獲得核准以取得容器存取權。
- 相較於雲端供應項目，翻譯工具容器映像僅支援有限的功能。

資料落地

文字翻譯資料落地取決於建立翻譯工具資源的 Azure 區域：

文字翻譯資料落地

✔️ 功能：翻譯工具文字

服務端點	要求處理資料中心
全域 (建議)： `api.cognitive.microsofttranslator.com`	最接近的可用資料中心。
美洲： `api-nam.cognitive.microsofttranslator.com`	美國東部 2 • 美國西部 2
亞太地區： `api-apc.cognitive.microsofttranslator.com`	日本東部 • 東南亞
歐洲 (瑞士除外)： `api-eur.cognitive.microsofttranslator.com`	法國中部 • 西歐
瑞士：如需詳細資訊，請參閱瑞士服務端點。	瑞士北部 • 瑞士西部

瑞士服務端點

資源位於瑞士北部或瑞士西部的客戶，可確保在瑞士內提供其文字 API 要求。為確保在瑞士處理要求，請在 Resource region Switzerland 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

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

開始使用文字翻譯

準備開始

在 Azure 入口網站中建立翻譯工具資源。
取得您的存取金鑰和 API 端點。需要端點 URL 和唯讀金鑰才能進行驗證。
探索我們的快速入門，並檢視下列程式設計語言的使用案例和程式碼範例：

下一步

深入了解文字翻譯 REST API：

參閱 REST API 參考

共用方式為