定义自定义翻译

5 分钟

虽然 Azure AI Translator 使用的默认翻译模型对于常规翻译有效，但可能需要为具有需要自定义翻译的术语的特定词汇的企业或行业开发翻译解决方案。

若要解决此问题，可以创建一个自定义模型，用于映射自己的源和目标术语集以供翻译。若要创建自定义模型，请使用自定义翻译门户：

显示自定义翻译门户的

自定义模型分配了唯一的 类别 ID（屏幕截图中突出显示），可以在 使用类别参数将 调用转换为 Azure AI Translator 资源，从而导致自定义模型而不是默认模型执行翻译。

如何调用 API

若要启动翻译，请将 POST 请求发送到以下请求 URL：

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

请求需要包括几个参数：

api-version：所需的 API 版本。
to：要翻译的目标语言。例如：to=fr 法语。
category：类别 ID。

请求还必须包含许多必需的标头：

Ocp-Apim-Subscription-Key。客户端密钥的标头。例如： Ocp-Apim-Subscription-Key=<your-client-key>。
Content-Type。有效负载的内容类型。所需的格式为：Content-Type: application/json; charset=UTF-8。

请求正文应包含一个包含 JSON 对象的数组，其中包含一个 Text 属性，该属性指定要翻译的文本：

[
    {"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

返回的响应

反馈