如何通过API构建Azure自定义翻译模型？求全流程相关文档

Azure自定义翻译的API集成在Azure AI Translator服务中，以下是覆盖工作区创建、项目搭建、模型训练的全流程操作步骤，以及官方文档的获取路径：

一、前置准备 #

• 已创建Azure AI Translator资源，获取对应的资源密钥和端点地址
• 确保有足够的权限操作资源（可在Azure门户中配置）

二、分步API操作 #

1. 创建工作区 #

通过POST /workspaces端点创建工作区，示例请求：

POST https://<你的Translator端点>/customtranslator/v1.0/workspaces
Headers:
  Ocp-Apim-Subscription-Key: <你的资源密钥>
  Content-Type: application/json
Body:
{
  "name": "TechDocsTranslationWorkspace",
  "description": "Workspace for technical document translation models"
}

响应会返回工作区ID，后续操作需用到该ID。

2. 创建翻译项目 #

在指定工作区下创建项目，使用POST /workspaces/{workspaceId}/projects端点：

POST https://<你的Translator端点>/customtranslator/v1.0/workspaces/{workspaceId}/projects
Headers:
  Ocp-Apim-Subscription-Key: <你的资源密钥>
  Content-Type: application/json
Body:
{
  "name": "En-ZhTechDocsProject",
  "sourceLanguage": "en",
  "targetLanguage": "zh-Hans",
  "description": "Custom translation for English to Chinese technical docs"
}

响应返回项目ID，用于后续语料上传和模型训练。

3. 上传训练/验证语料 #

通过多部分表单上传平行语料，使用POST /workspaces/{workspaceId}/projects/{projectId}/documents端点：

POST https://<你的Translator端点>/customtranslator/v1.0/workspaces/{workspaceId}/projects/{projectId}/documents
Headers:
  Ocp-Apim-Subscription-Key: <你的资源密钥>
  Content-Type: multipart/form-data
Form Data:
  - documentType: "Training" // 可选值：Training/Validation/Testing
  - sourceFile: <本地源语言文件>
  - targetFile: <本地目标语言文件>
  - name: "TechTrainingCorpusV1"

上传后可通过GET /workspaces/{workspaceId}/projects/{projectId}/documents查询文档处理状态，需等待状态变为Processed再进行下一步。

4. 触发模型训练 #

语料处理完成后，调用POST /workspaces/{workspaceId}/projects/{projectId}/models启动训练：

POST https://<你的Translator端点>/customtranslator/v1.0/workspaces/{workspaceId}/projects/{projectId}/models
Headers:
  Ocp-Apim-Subscription-Key: <你的资源密钥>
  Content-Type: application/json
Body:
{
  "name": "TechDocsTransModelV1",
  "baseModel": "general", // 可选基础模型，如general、conversational
  "trainingDocumentIds": ["<训练文档ID>"],
  "validationDocumentIds": ["<验证文档ID>"]
}

5. 查询训练状态与获取模型 #

使用GET /workspaces/{workspaceId}/projects/{projectId}/models/{modelId}查询训练状态，当状态为Succeeded时，即可使用该模型ID进行自定义翻译调用。

三、官方文档获取 #

官方完整的API文档集成在Azure AI Translator的官方文档集中，你可以在Azure文档平台搜索「Azure AI Translator Custom Translator API」找到全流程的接口说明，涵盖工作区、项目、文档、模型的所有操作细节。

内容的提问来源于stack exchange，提问作者Darshan G