LAS 为您提供多个在线算子 API，您可单个调用对应算子 API，同时，LAS 也为您提供了批量提交算子任务的批任务（Batch Task） API，通过 Batch Task API，您可通过一次批任务同时提交多个算子子任务，可减少 submit/poll API 使用次数，减少等待时 client 端资源占。本文为您介绍 Batch Task 涉及的 API 列表、参数介绍及使用示例。

Batch Task 处理链路 #

Batch Task 为您提供了 submit、get、list 等接口，通过 Batch Task 的 submit 接口提交批任务时，您可以指定本次批任务包含哪些算子处理的子任务，将子任务的任务详情通过 input.json 文件上传到 TOS，Batch Task 读取 TOS 中需要批量处理的子任务列表后，批量提交子任务，并将任务处理结果写回 TOS 指定的输出路径中。

术语 #

• 批任务（Batch Task）：一次离线批处理作业的顶层实体，包含输入文件、输出目录、目标算子、状态、统计计数与运行参数等。
• 子任务（Subtask）：批任务拆分后的最小执行单元，通常对应输入 JSONL 的一行；每个子任务最终会关联一个底层 task_id（复用现有 submit/poll 异步任务）。
• 结果文件（Result File）：批任务完成后写入 TOS 的 results.jsonl 与 errors.jsonl。

接口性能 #

• 每个批任务的子任务并发限制：默认为10，如果您希望提高子任务并发数，可提交工单联系技术支持人员，提高子任务并发度。
• 批任务的并发限制：默认 10

输入：input.jsonl #

批任务以“文件驱动”的方式运行：您需要上传输入文件到 TOS，服务端负责拆分、编排、聚合。

{"custom_id":"000001","data":{"url": "https://las-ai-cn-shanghai-online.tos-cn-shanghai.volces.com/v1/pdf-sample.pdf", "parse_mode": "normal" }}
{"custom_id":"000002","data":{"url": "https://las-ai-cn-shanghai-online.tos-cn-shanghai.volces.com/v1/pdf-sample-02.pdf", "parse_mode": "normal" }}

输出：results.jsonl / errors.jsonl #

批任务完成后在指定 TOS 输出目录下写入标准化结果文件。

{"id": "batch-task-123", "custom_id": "000001", "metadata": {"task_id": "xxx", "task_status": "COMPLETED", "business_code": 0}, "data": {"markdown": "我的小狗 \\n我家有一只可爱的小狗,它的名字叫小白｡", "detail": [{"page_id": 1, "page_md": "我的小狗 \\n我家有一只可爱的小狗,它的名字叫小白｡",  "page_image_hw": {"h": 3508, "w": 2480}, "text_blocks":[]}]}}
{"id": "batch-task-123", "custom_id": "000002", "metadata": {"task_id": "xxx", "task_status": "COMPLETED", "business_code": 0}, "data": {"markdown": "我的小狗 \\n我家有一只可爱的小狗,它的名字叫小白｡", "detail": [{"page_id": 1, "page_md": "我的小狗 \\n我家有一只可爱的小狗,它的名字叫小白｡",  "page_image_hw": {"h": 3508, "w": 2480}, "text_blocks":[]}]}}

{"id": "batch-task-123", "custom_id": "000001", "metadata": {"task_id": "xxx", "task_status": "FAILED", "business_code": "Parameter.Invalid", "error_msg": "Url is invalid"}}

创建批任务（submit） #

使用 submit 创建任务，返回 batch_task_id。

请求参数 #

返回参数 #

请求示例 #

# submit
curl --location "${BASE_URL}/api/v1/batch-task/submit" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data '{
    "name": "demo_batch_task",
    "description": "batch task demo",
    "operator_id": "las_long_video_understand",
    "operator_version": "v1",
    "input_tos_url": "tos://liuliu-test/batch_task_test/input_1.jsonl",
    "output_tos_url": "tos://liuliu-test/batch_task_test/output/",
    "extra_params": {
      "model_name": "doubao-seed-2-0-lite-260215"
    },
    "project_name": "default"
  }'

返回示例 #

{
  "batch_task_id": "bt-1234567890"
}

查询任务进度（get） #

1. 调用 get，并传入 batch_task_id。
2. 关注返回的 status 与 request_counts（total/completed/failed/terminated）。
3. 当任务进入终态后，结合 output_tos_url 获取结果文件。

请求参数 #

返回参数 #

BatchTaskDetail 结构

RequestCounts 结构

请求示例 #

# get
curl --location "${BASE_URL}/api/v1/batch-task/get" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data "{\n    \"batch_task_id\": \"${BATCH_TASK_ID}\"\n  }" 

返回示例 #

{
  "batch_task_detail": {
    "batch_task_id": "bt-1234567890",
    "name": "demo_batch_task",
    "description": "batch task demo",
    "input_tos_url": "tos://liuliu-test/batch_task_test/input_100.jsonl",
    "output_tos_url": "tos://liuliu-test/batch_task_test/output/",
    "status": "RUNNING",
    "request_counts": {
      "total": 100,
      "completed": 80,
      "failed": 2,
      "terminated": 0
    },
    "create_time": "2026-07-13T03:10:11Z",
    "update_time": "2026-07-13T03:20:00Z",
    "stop_time": "",
    "end_time": "",
    "error_message": "",
    "owner_id": 12345678
  }
}

列表查询（list） #

用于批量查看任务列表。

请求参数 #

返回参数 #

BatchTaskSummary结构

RequestCounts 结构

请求示例 #

# list
curl --location "${BASE_URL}/api/v1/batch-task/list" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data "{\n    \"batch_task_ids\": [\"batch_001\", \"batch_002\"],\n    \"batch_task_name\": \"demo\",\n    \"statuses\": [\"QUEUED\", \"RUNNING\", \"FAILED\"],\n    \"owner_ids\": [12345678],\n    \"sort_order\": \"Desc\",\n    \"sort_by\": \"update_time\",\n    \"max_results\": 10,\n    \"next_token\": \"0\"\n  }" 

返回示例 #

{
  "items": [
    {
      "batch_task_id": "bt-1234567890",
      "name": "demo_batch_task",
      "description": "batch task demo",
      "output_tos_url": "tos://liuliu-test/batch_task_test/output/",
      "status": "RUNNING",
      "completion_window": 24,
      "request_counts": {
        "total": 100,
        "completed": 80,
        "failed": 2,
        "terminated": 0
      },
      "create_time": "2026-07-13T03:10:11Z",
      "stop_time": "",
      "end_time": "",
      "error_message": "",
      "owner_id": 12345678
    }
  ],
  "total_count": 1,
  "max_results": 10,
  "next_token": "0"
}

停止任务（stop） #

当需要终止执行时：

1. 调用 stop，传入 batch_task_id。
2. 任务会进入 TERMINATING，最终到 TERMINATED。

请求参数 #

返回参数 #

请求示例 #

# stop
curl --location "${BASE_URL}/api/v1/batch-task/stop" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data "{\n    \"batch_task_id\": \"${BATCH_TASK_ID}\"\n  }" 

返回示例 #

{
  "batch_task_id": "bt-1234567890"
}

更新任务元信息（update） #

update 用于更新批任务的元信息（如 name、description）。

请求参数 #

返回参数 #

请求示例 #

# update
curl --location "${BASE_URL}/api/v1/batch-task/update" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data "{\n    \"batch_task_id\": \"${BATCH_TASK_ID}\",\n    \"name\": \"demo_batch_task_updated\",\n    \"description\": \"updated description\"\n  }" 

返回示例 #

{
  "batch_task_id": "bt-1234567890"
}

删除任务（delete） #

delete 用于删除批任务（控制面操作），通常用于清理不再需要的任务记录。

请求参数 #

返回参数 #

请求示例 #

# delete
curl --location "${BASE_URL}/api/v1/batch-task/delete" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer ${API_KEY}" \
  --data "{\n    \"batch_task_id\": \"${BATCH_TASK_ID}\"\n  }" 

返回示例 #

{
  "batch_task_id": "bt-1234567890"
}

批任务状态参考 #

常见问题与异常处理 #