> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rivus.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 任务查询

> 查询 creations 与取消任务（非 API 规范）

查询任务（creations）

```bash theme={null}
curl --request GET \
  --url https://models.kapon.cloud/vidu/ent/v2/tasks/$TASK_ID/creations \
  --header 'Authorization: Bearer <kapon Token>'
```

响应示例（成功场景）

```json theme={null}
{
  "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（开启水印时）。

取消任务

```bash theme={null}
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 定时轮询本接口即可。