定义自定义翻译

5 分钟

Azure AI 翻译使用的默认翻译模型对于常规内容的翻译较有效，但你可能需要为使用专业术语词汇的企业或行业开发翻译解决方案，这就需要用到自定义翻译。

若要解决此问题，可以创建用于映射自己的源和目标术语集进行翻译的自定义模型。若要创建自定义模型，请使用自定义翻译工具门户来执行以下操作：

创建工作区并链接到 Azure AI 翻译资源。
创建项目。
上传训练数据文件和训练模型。
测试模型和发布模型。
对 API 进行翻译调用。

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

如何调用 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

返回的响应

反馈