提交翻译任务。可通过传入 TaskId 提交新翻译任务，或通过传入 BaseTaskId 对历史任务重新发起翻译。提交成功后返回任务 ID 及当前任务状态。
本接口涉及 Credits 消耗。提交前请确保账户 Credits 余额充足，可提前参考 UploadTranslationFile 返回的 CreditsAvailable 字段，最终以提交结果为准。余额不足时，提交请求会失败并返回 Credits.NotEnough。
请求参数
由 UploadTranslationFile 获取的任务 ID。与 BaseTaskId 二者选其一。
重新提交翻译时传入，为已提交过的历史任务 ID。与 TaskId 二者选其一。
必填。翻译配置。
SourceLanguage 与 TargetLanguage 必须组成支持的语言对，完整可选范围请参阅支持的格式与语言。翻译风格，仅当翻译文件为 PPT 时生效。
normal — 常规，原文信息完整保留minimal — 信息更凝练，布局更美观
自定义术语列表，最多 100 条。仅影响当次任务。自定义术语仅供参考，实际翻译结果可能存在差异，请以最终输出为准。
响应参数
任务状态。提交后通常为 PENDING。可能的值：ANALYZED、PENDING、PROCESSING、COMPLETED、FAILED、CANCELLED
调用示例
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());
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 | 文档命中敏感内容 |
