SubmitTranslationTask 提交翻译任务

介绍 SubmitTranslationTask 接口的请求参数、支持的语言对、响应字段与调用示例。

警告

本接口涉及 Credits 消耗。提交前请确保账户 Credits 余额充足，可提前参考 UploadTranslationFile 返回的 CreditsAvailable 字段，最终以提交结果为准。余额不足时，提交请求会失败并返回 Credits.NotEnough。

说明

流控限制：单账号 5 QPS，并发 5。

请求参数

参数	类型	必填	说明
TaskId	string	条件必填	由 `UploadTranslationFile` 获取的任务 ID。与 `BaseTaskId` 二者选其一。
BaseTaskId	string	条件必填	重新提交翻译时传入，为已提交过的历史任务 ID。与 `TaskId` 二者选其一。
Config	object	是	翻译配置对象。
Config.SourceLanguage	string	是	源文件语种代码，如 `zh`、`en`、`ja`。`SourceLanguage` 与 `TargetLanguage` 必须组成支持的语言对，完整可选范围请参阅支持的格式与语言。
Config.TargetLanguage	string	是	目标语种代码，如 `en`、`zh`、`ja`。
Config.Font	string	否	目标字体。可选值通过 `UploadTranslationFile` 返回的 `Fonts` 字段获取；历史任务重新翻译可通过 GetTranslationTask 获取。
Config.Style	string	否	翻译风格，仅当翻译文件为 PPT 时生效。`normal`：常规，原文信息完整保留；`minimal`：信息更凝练，布局更美观。
Config.GlossaryIds	array<string>	否	术语库 ID 列表。指定后翻译引擎优先匹配术语库中的词条。
CustomTerms	array<object>	否	自定义术语列表，最多 100 条。仅影响当次任务。
CustomTerms[].SourceTerm	string	-	原文术语。
CustomTerms[].TargetTerm	string	-	译文术语。

说明

自定义术语仅供参考，实际翻译结果可能存在差异，请以最终输出为准。

响应参数

参数	类型	说明
TaskId	string	翻译任务 ID。
Status	string	任务状态。提交后通常为 `PENDING`。可能的值：`ANALYZED`、`PENDING`、`PROCESSING`、`COMPLETED`、`FAILED`、`CANCELLED`。

调用示例

Java - 新任务

import com.aliyun.realtranslationagent20260622.models.*;

import java.util.ArrayList;
import java.util.List;

// 构造翻译配置
SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig config =
        new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig()
                .setSourceLanguage("zh")
                .setTargetLanguage("en")
                .setFont("Calibri")
                .setStyle("normal");

// 构造自定义术语（可选）
List<SubmitTranslationTaskRequest.SubmitTranslationTaskRequestCustomTerms> customTerms = new ArrayList<>();
customTerms.add(new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestCustomTerms()
        .setSourceTerm("人工智能")
        .setTargetTerm("Artificial Intelligence"));
customTerms.add(new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestCustomTerms()
        .setSourceTerm("机器学习")
        .setTargetTerm("Machine Learning"));

// 提交任务
SubmitTranslationTaskRequest request = new SubmitTranslationTaskRequest()
        .setTaskId("your-task-id")  // 来自 UploadTranslationFile
        .setConfig(config)
        .setCustomTerms(customTerms);

SubmitTranslationTaskResponse response = client.submitTranslationTask(request);
System.out.println("TaskId: " + response.getBody().getData().getTaskId());
System.out.println("状态: " + response.getBody().getData().getStatus());

Java - 重新翻译

SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig config =
        new SubmitTranslationTaskRequest.SubmitTranslationTaskRequestConfig()
                .setSourceLanguage("zh")
                .setTargetLanguage("ja")
                .setFont("MS Mincho");

SubmitTranslationTaskRequest request = new SubmitTranslationTaskRequest()
        .setBaseTaskId("history-task-id")  // 历史任务 ID
        .setConfig(config);

SubmitTranslationTaskResponse response = client.submitTranslationTask(request);

响应示例

{
  "Data": {
    "TaskId": "f9c35b0453b",
    "Status": "PENDING"
  }
}

注意事项

TaskId 与 BaseTaskId 必须二选一，不可同时传入
Style 参数仅对 PPT 文件生效，其他格式传入该参数不产生效果
提交后 Credits 会被冻结，任务完成后按实际消耗结算，取消任务全额返还

错误码

错误码	说明
`InvalidParameter`	参数校验失败
`InvalidParameter.Config`	翻译配置不合法
`Task.NotFound`	任务不存在或无权访问
`Credits.NotEnough`	Credits 余额不足
`Sensitive.Blocked`	文档命中敏感内容