查询任务

GET /tasks：按任务 ID 或自定义任务 ID 查询文生视频、图生视频、动作控制、全能参考视频任务

GET/tasks

查询文生视频、图生视频、动作控制、全能参考视频任务。

项	值
模式	同步查询
计费	查询不收费

快速开始

curl "https://api.vibelab.me/tasks?task_ids=893605946402811985,893605946402811986" \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY"

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": [
    {
      "id": "893605946402811985",
      "status": "succeeded",
      "message": "",
      "create_time": 1781080778802,
      "update_time": 1781080794151,
      "external_id": "your-id",
      "outputs": [
        {
          "type": "video",
          "id": "893605946402811986",
          "url": "https://example.com/result.mp4",
          "watermark_url": "https://example.com/result-wm.mp4",
          "duration": "5"
        }
      ]
    }
  ]
}

请求参数

请求头

参数	类型	必填	默认	说明
`Authorization`	string	是	-	`Bearer $LOOPTOKEN_API_KEY`

查询参数

参数	类型	必填	默认	说明
`task_ids`	string	二选一	-	任务 ID，多个用英文逗号分隔，最多 100 个
`external_task_ids`	string	二选一	-	自定义任务 ID，多个用英文逗号分隔，最多 100 个

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data[]`	array	任务列表，字段见下
`data[].id`	string	任务 ID
`data[].status`	string	`submitted`、`processing`、`succeeded`、`failed`
`data[].message`	string	失败原因
`data[].create_time`、`data[].update_time`	integer	Unix 毫秒时间戳
`data[].external_id`	string	自定义任务 ID
`data[].outputs[].type`	string	`video`
`data[].outputs[].id`	string	视频 ID
`data[].outputs[].url`	string	视频地址，30 天后清理，请及时转存
`data[].outputs[].watermark_url`	string	含水印视频地址
`data[].outputs[].duration`	string	视频时长，单位秒

计费

查询不收费。

错误

本页参数校验返回 400 / 1201，message 原文如下：

HTTP	`code`	触发场景	处理
400	`1201`	`exactly one of task_ids and external_task_ids is required`	两个参数二选一，不能都传也不能都不传
400	`1201`	`at most 100 ids per query`	拆成多次查询

通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。

注意事项

查不到的 ID → 不报错，该 ID 不出现在 data 中（任务不存在或不属于当前账号时返回空数组）。
查询范围 → 只能查询自己最近 30 天的任务。
适用范围 → 仅文生视频、图生视频、动作控制、全能参考视频；数字人、音效、对口型、多模态编辑使用各自的查询接口。

查询任务

本页内容