任务查询

查询视频生成任务的当前状态与结果

任务查询 API 允许你检索通过视频生成接口发起的任务进度和最终结果。

接口路径

GET /api/ai/videos/[taskId]

极速轮询查询 你可以安全地每 3 到 5 秒轮询一次此接口。

请求参数

taskId (Path 路径参数, String, 必填)

生成 API 返回的任务 ID（纯数字字符串）。

请求示例

curl -X GET "https://qxan.net/api/ai/videos/2044657634195480577" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应

API 返回一个 JSON 对象，详细说明任务的当前状态、时间戳以及成功后的最终数据。

{
  "id": "2044657634195480577",
  "object": "video",
  "created": 1716398000,
  "model": "runninghub-i2v-v1",
  "status": "success",
  "data": [
    {
      "url": "https://rh-images.xiaoyaoyou.com/1fed4ce62b6a35e17d9103980f90ef6a/output/ComfyUI_00001_ynbbq_1776760390.png",
      "cover_url": null
    }
  ],
  "error": null
}

响应字段说明

字段	类型	说明
`id`	String	任务ID
`object`	String	固定值 `"video"`
`created`	Integer	任务创建时间戳（Unix秒）
`model`	String	使用的模型名称
`status`	String	任务状态
`data`	Array	生成的文件数组
`data[].url`	String	文件访问地址
`data[].cover_url`	String/null	视频封面地址（如有）
`error`	Object/null	错误信息，成功时为 null

状态生命周期 (Status)

status 字段可能包含以下值之一：

pending — 任务已被接受，正在等待处理。
processing — 任务当前正在生成中。
success — 任务已完成。data 字段将包含输出文件信息。
failed — 任务遇到错误。详情请查看 error 字段。

错误响应

{
  "id": "2044657634195480577",
  "object": "video",
  "created": 1716398000,
  "model": "runninghub-i2v-v1",
  "status": "failed",
  "data": [],
  "error": {
    "code": "timeout",
    "message": "Task timed out"
  }
}

On this page