Skip to main content
接口文档

ListTranslationTasks 分页查询翻译任务

分页查询翻译任务列表,支持按状态、语言、时间等条件筛选。

分页查询翻译任务列表。默认按创建时间倒序排列,仅返回当前调用方自己的任务。支持按状态、语种、文件名和时间范围筛选。
流控限制:单账号 20 QPS。

请求参数

integer
body
default:"10"
每次最多返回的结果数。取值范围:1~100。
string
body
分页令牌。首次查询不传,后续查询传入上一次响应中返回的 NextToken
string
body
按任务 ID 精确筛选。
string
body
按源文件名称筛选。
string
body
按源文件语种筛选,如 zhen
string
body
按目标语种筛选,如 enja
string
body
按任务状态筛选。可选值:ANALYZEDPENDINGPROCESSINGCOMPLETEDFAILEDCANCELLED
string
body
起始时间筛选。格式:YYYY-MM-dd HH:mm:ss
string
body
结束时间筛选。格式:YYYY-MM-dd HH:mm:ss

响应参数

array<object>
任务列表。
integer
符合条件的总条数。
integer
每页返回的最大条数。
string
下一页的分页令牌。为空表示已到最后一页。

调用示例

  • Java - 基础分页
  • Java - 游标翻页
  • Java - 带筛选条件
ListTranslationTasksRequest request = new ListTranslationTasksRequest()
        .setMaxResults(10);

ListTranslationTasksResponse response = client.listTranslationTasks(request);
ListTranslationTasksResponseBody.ListTranslationTasksResponseBodyData data = response.getBody().getData();

System.out.println("总条数: " + data.getTotal());
for (ListTranslationTasksResponseBody.ListTranslationTasksResponseBodyDataList task : data.getList()) {
    System.out.println("TaskId: " + task.getTaskId() + ", 状态: " + task.getStatus()
            + ", 文件: " + task.getOriginalFileName());
}

响应示例

{
  "Data": {
    "List": [
      {
        "TaskId": "f9c35b0453b",
        "OriginalFileName": "quarterly-report.pptx",
        "Status": "COMPLETED",
        "Progress": 100,
        "SourceLanguage": "zh",
        "TargetLanguage": "en",
        "Template": "common",
        "FileFormat": "PPTX",
        "FileName": "quarterly-report.pptx",
        "TaskType": "DOCUMENT",
        "WordCount": 1600,
        "PageCount": 21,
        "CostCredits": 81.2992,
        "CostTime": 196000,
        "Creator": "acc_93****c936",
        "CreatorName": "test@example.com",
        "GmtCreate": "1782459562000",
        "StartTime": "1782459562000",
        "CompleteTime": "1782459758000",
        "ErrorMessage": "",
        "WorkSpaceId": "6458351****0cc5",
        "OrgId": "org_c6****cdc2ce7"
      }
    ],
    "Total": 50,
    "MaxResults": 10,
    "NextToken": "AAAAAVpfrV4aVmra0dxbtRB74lmSGzegoejeIqxIET/WdX50"
  }
}

错误码

错误码说明
InvalidParameter参数校验失败
InvalidParameter.Page分页参数不合法