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

# 任务查询

> 查询任务状态与取消任务

## 概述

视频生成任务为异步执行，创建成功后需通过本接口轮询结果或取消任务。

> \[!NOTE]
>
> * **本平台接口**：`GET https://models.hingnet.com.cn/vidu/ent/v2/tasks/{task_id}/creations`
> * **官方接口**：`GET https://api.vidu.cn/ent/v2/tasks/{task_id}/creations`
> * `task_id` 参数同时接受上游原始任务 ID 和平台 `platform_id`（`video_<ULID>`）。

## 查询任务状态

```bash theme={null}
curl -X GET "https://models.hingnet.com.cn/vidu/ent/v2/tasks/$TASK_ID/creations" \
  -H "Authorization: Bearer <HingNet AI 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`     | 生成失败  |

### 返回字段

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

## 取消任务

```bash theme={null}
curl -X POST "https://models.hingnet.com.cn/vidu/ent/v2/tasks/$TASK_ID/cancel" \
  -H "Authorization: Bearer <HingNet AI Token>"
```

取消成功后返回已消耗的 `credits`（若有）。

## 轮询建议

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