開始使用同步翻譯

發行項
04/12/2024

文件翻譯是 Azure AI 翻譯工具服務的雲端式機器翻譯功能。您可以翻譯所有支援的語言和方言的多個複雜文件，同時保留原始文件結構和資料格式。

同步翻譯支援單頁檔案的即時回應處理。同步翻譯流程不需要 Azure Blob 儲存體帳戶。最終回應包含已翻譯的文件，並會直接傳回給呼叫用戶端。

現在就開始吧。

必要條件

您需要作用中的 Azure 訂用帳戶。若還沒有 Azure 訂閱，您可以建立免費帳戶。

擁有 Azure 訂閱之後，請在 Azure 入口網站中建立翻譯工具資源。
注意
- 在本快速入門中，除非您的業務或應用程式需要特定區域，否則建議您使用翻譯工具文字單一服務全域資源。如果您打算使用系統指派的受控識別進行驗證，請選擇地理區域，例如美國西部。
- 使用單一服務全域資源，您可在 REST API 要求中包含一個授權標頭 (Ocp-Apim-Subscription-key)。 Ocp-Apim-Subscription-key 的值是翻譯工具文字訂閱的 Azure 祕密金鑰。
部署資源之後，請選取 [前往資源] 擷取金鑰與端點。
- 您將需要來自資源的金鑰和端點，以將應用程式連線至翻譯工具服務。您稍後會在快速入門中將金鑰和端點貼到程式碼中。您可以在 Azure 入口網站的 [金鑰和端點] 頁面上找到這些值。
在此專案中，我們使用 cURL 命令列工具來進行 REST API 呼叫。

注意

cURL 套件已預先安裝在大部分 Windows 10 和 Windows 11 和大部分 macOS 和 Linux 發行版本上。您可以使用下列命令來檢查套件版本：Windows：curl.exe -V macOS curl -V Linux：curl --version
如果未安裝 cURL，則以下是適用於您的平台的安裝連結：
- Windows
- Mac 或 Linux

標頭和參數

若要透過 REST API 呼叫同步翻譯功能，您必須在每個要求中都包含下列標頭。別擔心，我們在範例程式碼中為您包含標頭。

注意

所有 cURL 旗標和命令列選項都會區分大小寫。

查詢參數	描述	條件
`-X` 或 `--requestPOST`	-X 旗標指定存取 API 的要求方法。	必要
`{endpoint}`	文件翻譯資源端點的 URL	必要
`targetLanguage`	指定輸出文件的語言。目標語言必須是翻譯範圍內包含的支援語言之一。	必要
`sourceLanguage`	指定輸入文件的語言。若未指定 `sourceLanguage` 參數，則會套用自動語言偵測來判斷來源語言。	選擇性
`-H` 或 `--header"Ocp-Apim-Subscription-Key:{KEY}`	要求標頭，指定授權存取 API 的文件翻譯資源金鑰。	必要
`-F` 或 `--form`	您想要包含在要求中之文件的檔案路徑。只允許一個來源文件。	必要
• `document=` • `type={contentType}/fileExtension`	• 來源文件檔案位置的路徑。 • 內容類型和副檔名。例如："document=@C:\Test\test-file.md;type=text/markdown	必要
`-o` 或 `--output`	回應結果的檔案路徑。	必要
`-F` 或 `--form`	要包含在要求中的選擇性詞彙的檔案路徑。詞彙需要個別的 `--form` 旗標。	選擇性
• `glossary=` • `type={contentType}/fileExtension`	• 選擇性詞彙檔案的檔案位置路徑。 • 內容類型和副檔名。例如："glossary=@C:\Test\glossary-file.txt;type=text/plain	選擇性

✔️ 如需 contentType 的詳細資訊，請參閱支援的文件格式。

建置並執行 POST 要求

針對此專案，您需要範例文件。您可以下載本快速入門的 Microsoft Word 範例文件。來源語言為英文。

執行 POST 要求之前，請使用 Azure 入口網站翻譯工具服務執行個體中的值取代 {your-document-translation-endpoint} 和 {your-key}。

重要

完成時，請記得從程式碼中移除金鑰，且不要公開張貼金鑰。在生產環境中，請使用安全的方式來儲存和存取您的認證，例如 Azure Key Vault。如需詳細資訊，請參閱 Azure AI 服務安全性。

命令提示字元/終端機


curl -i -X POST "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=hi&api-version=2023-11-01-preview" -H "Ocp-Apim-Subscription-Key:{your-key}"  -F "document={path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -F "glossary={path-to-your-glossary-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file}"

PowerShell

cmd /c curl "{your-document-translation-endpoint}/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2023-11-01-preview" -i -X POST  -H "Ocp-Apim-Subscription-Key: {your-key}" -F "{path-to-your-document-with-file-extension};type=text/{file-extension}" -o "{path-to-output-file}

✔️ 如需 Query parameters 的詳細資訊，請參閱標頭和參數。

成功完成時：

翻譯的文件會以回應傳回。
成功的 POST 方法會傳回 200 OK 回應碼，指出服務已建立要求。

沒錯，恭喜！您剛了解如何使用 Azure AI 翻譯工具服務同步翻譯文件。

下一步

非同步批次轉譯

開始使用同步翻譯

必要條件

標頭和參數

建置並執行 POST 要求

下一步

其他資源