GetTranslationTask 获取翻译任务详情

获取翻译任务详情，返回任务的完整状态、翻译配置、消耗信息和元数据。常用于轮询任务进度。

建议轮询间隔为 3~5 秒，支持秒级轮询。

流控限制：单账号 20 QPS。

请求参数

string

body

必填。翻译任务 ID。

响应参数

string

翻译任务 ID。

string

来源任务 ID。仅在通过 BaseTaskId 重新翻译时有值。

string

用户上传时的原始文件名。

string

任务状态。

值	说明
`ANALYZED`	已分析，等待提交
`PENDING`	已提交，等待处理
`PROCESSING`	翻译处理中
`COMPLETED`	翻译完成
`FAILED`	翻译失败
`CANCELLED`	已取消

integer

翻译进度百分比，0~100，单调递增不回退。

object

翻译配置。

Show Config 字段

string

源文件语种。

string

目标语种。

string

翻译风格（normal / minimal）。

string

保密级别。

string

翻译模板。

integer

文档字数统计。

integer

文档页数统计。

string

文件格式，如 DOCX、DOC、PPTX、PPT、XLSX、XLS、PDF、TXT、MD、MP4、JPG、JPEG、PNG、WEBP。

string

文件名称。

string

任务类型。目前为 DOCUMENT（文档翻译）。

double

预估消耗 Credits。

integer

预估翻译时长，单位秒。

double

实际消耗 Credits。任务完成后回写。

integer

实际耗时，单位毫秒。

string

任务完成时间，13 位时间戳。

string

失败原因。仅当状态为 FAILED 时有值。

object

支持修改字体的语言和对应字体列表。

array<object>

本次任务使用的术语列表。

Show ExtractedTerms 项字段

string

原文术语。

string

译文术语。

string

所属工作空间 ID。

string

所属组织 ID。

调用示例

Java - 单次查询
Java - 轮询等待完成

GetTranslationTaskRequest request = new GetTranslationTaskRequest()
        .setTaskId("your-task-id");

GetTranslationTaskResponse response = client.getTranslationTask(request);
GetTranslationTaskResponseBody.GetTranslationTaskResponseBodyData data = response.getBody().getData();

System.out.println("状态: " + data.getStatus());
System.out.println("进度: " + data.getProgress() + "%");
System.out.println("文件名: " + data.getOriginalFileName());

String taskId = "your-task-id";
String status;

do {
    Thread.sleep(5000); // 每 5 秒轮询一次

    GetTranslationTaskRequest request = new GetTranslationTaskRequest()
            .setTaskId(taskId);
    GetTranslationTaskResponse response = client.getTranslationTask(request);
    GetTranslationTaskResponseBody.GetTranslationTaskResponseBodyData data = response.getBody().getData();

    status = data.getStatus();
    System.out.println("进度: " + data.getProgress() + "%, 状态: " + status);
} while ("PENDING".equals(status) || "PROCESSING".equals(status));

if ("COMPLETED".equals(status)) {
    System.out.println("翻译完成！");
} else if ("FAILED".equals(status)) {
    System.out.println("翻译失败");
}

响应示例

{
  "Data": {
    "TaskId": "f9c35b0453b",
    "OriginalFileName": "quarterly-report.docx",
    "Status": "COMPLETED",
    "Progress": 100,
    "Config": {
      "SourceLanguage": "zh",
      "TargetLanguage": "en",
      "Style": "normal",
      "SecurityLevel": "public",
      "Template": "common"
    },
    "WordCount": 1600,
    "PageCount": 10,
    "FileFormat": "DOCX",
    "FileName": "quarterly-report.docx",
    "TaskType": "DOCUMENT",
    "EstimatedCostCredits": 2.551,
    "EstimatedTime": 40,
    "CostCredits": 2.551,
    "CostTime": 43000,
    "FinishedAt": "1782381662000",
    "ErrorMessage": "",
    "Fonts": {
      "en": ["Times New Roman", "Calibri", "Arial"]
    },
    "ExtractedTerms": [
      { "SourceTerm": "人工智能", "TargetTerm": "Artificial Intelligence" }
    ],
    "WorkSpaceId": "c2b898f****c985c",
    "OrgId": "org_e5b74****9c94209"
  }
}

错误码

错误码	说明
`InvalidParameter`	参数校验失败
`Task.NotFound`	任务不存在或无权访问

​请求参数

​响应参数

​调用示例

​响应示例

​错误码

请求参数

响应参数

调用示例

响应示例

错误码