什麼是 Azure 文字翻譯？

發行項
05/04/2024

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

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

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

文字翻譯功能

文字翻譯支援下列方法：

語言。傳回翻譯、音譯和字典查閱作業所支援的語言清單。此要求不需要驗證；只要將下列 GET 要求複製並貼到 Postman 或您慣用的 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 要求可在瑞士內提供服務。若要確保要求是在瑞士處理，請在或 Switzerland West中Resource regionSwitzerland North建立翻譯工具資源，然後在 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 參考