任务查询 - Rivus AI 用户文档

查询任务（creations）

curl --request GET \
  --url https://models.kapon.cloud/vidu/ent/v2/tasks/$TASK_ID/creations \
  --header 'Authorization: Bearer <kapon Token>'

响应示例（成功场景）

{
  "id": "176843862716480",
  "state": "success",
  "credits": 10,
  "creations": [
    {
      "id": "creation_123",
      "url": "https://your.cdn/generate/abc.mp4",
      "cover_url": "https://your.cdn/generate/abc.jpg",
      "watermarked_url": "https://your.cdn/generate/abc_wm.mp4"
    }
  ]
}

状态枚举

created / queueing / processing / success / failed

常见用法（调用侧关注点）

轮询策略建议：
- 间隔 3–5s 比较合适，避免过于频繁轮询；
- 单次任务的 timeout 建议 5–10 分钟，根据你的视频时长和模型选择调整。
计费字段：
- credits 表示本次任务消耗的积分（成功时才会扣除），1 积分 = 0.03125 元；
- 在 kapon ai 上，Vidu 的积分价格已经折算为人民币单价，你只需要关注调用频率与大致成本即可。
结果字段：
- creations[0].url：生成视频的临时访问 URL；
- creations[0].cover_url：封面图 URL；
- creations[0].watermarked_url：带水印视频 URL（开启水印时）。

取消任务

curl --request POST \
  --url https://models.kapon.cloud/vidu/ent/v2/tasks/$TASK_ID/cancel \
  --header 'Authorization: Bearer <kapon Token>'

说明

返回体包含消耗的 credits（若有）、creations（成功时）等；结构与官方一致。
若你在创建任务时配置了 callback_url，Vidu 会在状态变化时主动回调，通常仍建议在回调失败或超时时再兜底调用查询接口；
对于只使用 kapon ai 网关的场景，可以不配置 callback_url，直接按任务 ID 定时轮询本接口即可。

Vidu