Skip to main content

​
概述

视频生成任务为异步执行，创建成功后需通过本接口轮询结果或取消任务。
[!NOTE]
  • 本平台接口：GET https://models.kapon.cloud/vidu/ent/v2/tasks/{task_id}/creations
  • 官方接口：GET https://api.vidu.cn/ent/v2/tasks/{task_id}/creations

​
查询任务状态

curl -X GET "https://models.kapon.cloud/vidu/ent/v2/tasks/$TASK_ID/creations" \
  -H "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生成失败

​
返回字段

字段说明
creations[].url生成视频的临时访问 URL
creations[].cover_url封面图 URL
creations[].watermarked_url带水印视频 URL（开启水印时）
credits消耗积分（成功时扣除）

​
取消任务

curl -X POST "https://models.kapon.cloud/vidu/ent/v2/tasks/$TASK_ID/cancel" \
  -H "Authorization: Bearer <kapon Token>"
取消成功后返回已消耗的 credits（若有）。

​
轮询建议

  • 轮询间隔：3–5 秒
  • 超时时间：建议 5–10 分钟，根据视频时长调整
  • 回调机制：创建任务时设置 callback_url，状态变化时自动回调