查询数字人任务

GET /v1/videos/avatar/image2video/{id}：按 task_id 或 external_task_id 查询数字人任务

GET/v1/videos/avatar/image2video/{id}

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

快速开始

curl "https://api.vibelab.me/v1/videos/avatar/image2video/893605946402811985" \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY"

响应示例：

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
  "data": {
    "task_id": "893605946402811985",
    "task_status": "succeed",
    "task_status_msg": "",
    "task_info": {
      "external_task_id": "your-id"
    },
    "task_result": {
      "videos": [
        {
          "id": "893605946402811986",
          "url": "https://example.com/result.mp4",
          "watermark_url": "https://example.com/result-wm.mp4",
          "duration": "5.0"
        }
      ]
    },
    "created_at": 1722769557708,
    "updated_at": 1722769600000
  }
}

请求参数

请求头

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

路径参数

参数	类型	必填	默认	说明
`id`	string	是	-	数字人任务的 `task_id`，或创建时传入的 `external_task_id`

响应

字段	类型	说明
`code`	integer	`0` 表示成功，其余见错误
`message`	string	错误信息
`request_id`	string	请求 ID，排查问题时提供
`data.task_id`	string	任务 ID
`data.task_status`	string	`submitted`、`processing`、`succeed`、`failed`
`data.task_status_msg`	string	失败原因
`data.task_info.external_task_id`	string	自定义任务 ID
`data.task_result.videos[].id`	string	视频 ID
`data.task_result.videos[].url`	string	视频地址，30 天后清理，请及时转存
`data.task_result.videos[].watermark_url`	string	含水印视频地址，仅请求了水印时有值
`data.task_result.videos[].duration`	string	视频时长，单位秒
`data.created_at`、`data.updated_at`	integer	Unix 毫秒时间戳

计费

查询不收费。

错误

HTTP	`code`	触发场景	处理
404	`1203`	`task not found`：任务不存在、不属于当前账号或已超过 30 天	核对 `id`

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

注意事项

查询范围 → 只能查询自己最近 30 天的任务。

查询数字人任务

本页内容