定義自訂翻譯

5 分鐘

雖然 Azure AI 翻譯工具使用的預設翻譯模型對於一般翻譯已經相當有效，但是您可能必須為具有特定術語詞彙 (需要自訂翻譯) 的企業或產業發展翻譯解決方案。

若要解決這個問題，您可以建立自訂模型，以對應您自己的一組來源和目標術語以進行翻譯。若要建立自訂模型，請使用自訂翻譯工具入口網站來：

建立工作區連結至 Azure AI 翻譯工具資源。
建立專案。
上傳訓練資料檔案並定型模型。
測試模型並發佈模型。
對 API 進行翻譯呼叫。

您的自訂模型會獲指派一個唯一的分類識別碼 (會在螢幕擷取畫面中醒目提示)，您可以使用 category 參數在對 Azure AI 翻譯工具資源的翻譯呼叫中指定此識別碼，進而讓您的自訂模型 (而非預設模型) 執行翻譯。

如何呼叫 API

若要起始翻譯，請將 POST 要求傳送至下列要求 URL：

https://api.cognitive.microsofttranslator.com/translate?api-version=3.0

您的要求必須包含幾個參數：

api-version：API 的必要版本。
to：要翻譯成的目標語言。例如：法文的 to=fr。
category：您的 類別識別碼。

您的要求也必須包含一些必要的標頭：

Ocp-Apim-Subscription-Key. 用戶端金鑰的標頭。例如： Ocp-Apim-Subscription-Key=<your-client-key> 。
Content-Type. 承載的內容類型。必要格式為：Content-Type: application/json; charset=UTF-8。

要求本文應包含陣列，其中會包含具有 Text 屬性的 JSON 物件，該屬性會指定您要翻譯的文字：

[
    {"Text":"Where can I find my employee details?"}
]

您可以使用不同的方式將要求傳送至 API，包括使用 C#、Python 和 curl。例如，若要快速呼叫，您可以使用 curl 傳送 POST 要求：

curl -X POST "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&from=en&to=nl&category=<category-id>" -H "Ocp-Apim-Subscription-Key: <your-key" -H "Content-Type: application/json; charset=UTF-8" -d "[{'Text':'Where can I find my employee details?'}]"

上述要求會進行呼叫，將句子從英文翻譯成荷蘭文。

傳回的回應

如果要求成功，回應會傳回 200 的回應碼。它也會傳回包含翻譯文字的回應本文，如下所示：

[
    {
        "translations":[
            {"text":"Waar vind ik mijn personeelsgegevens?","to":"nl"}
        ]
    }
]

如果要求未成功，則可能會根據錯誤類型傳回一些不同的狀態碼，例如 400 (遺漏或不正確的查詢參數)。如需完整的代碼清單及其說明，請參閱回應狀態碼。

注意

如需自訂翻譯的詳細資訊，請參閱快速入門：使用自訂模型建置、發佈和翻譯。

定義自訂翻譯

如何呼叫 API

傳回的回應

意見反應