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

# Vidu 查询任务

> 使用 `GET /vidu/ent/v2/task/{task_id}/creations` 查询 Vidu 任务状态与结果。

# Vidu 查询任务

Vidu 官方格式任务查询接口,用于查询视频生成任务的状态与结果。

* 路由入口是 `GET /vidu/ent/v2/task/{task_id}/creations`。
* 通过路径参数 `task_id` 指定要查询的任务。
* 返回任务状态(`processing`、`completed`、`failed`)及视频下载地址。

## 方法与路径

```http theme={null}
GET /vidu/ent/v2/task/{task_id}/creations
```

## 请求示例

<CodeGroup>
  ```bash theme={null}
  curl -X GET https://octopusx.ai/vidu/ent/v2/task/48038932-0ff5-4251-8b4b-7a76c09fd114/creations \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python theme={null}
  import requests

  resp = requests.get(
      "https://octopusx.ai/vidu/ent/v2/task/48038932-0ff5-4251-8b4b-7a76c09fd114/creations",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      timeout=60,
  )
  print(resp.json())
  ```
</CodeGroup>

## 请求参数

<ParamField path="task_id" type="string" required>
  任务 ID。创建任务时返回的 `task_id`。
</ParamField>

## 认证

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## 响应示例

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "48038932-0ff5-4251-8b4b-7a76c09fd114",
    "status": "completed",
    "video_url": "https://example.com/video/aigcVideoGenFile.mp4",
    "status_update_time": 1774494622
  }
  ```
</ResponseExample>

## Response

<ResponseField name="id" type="string">
  任务 ID。
</ResponseField>

<ResponseField name="status" type="string">
  任务状态。可选值:`processing`(处理中)、`completed`(已完成)、`failed`(失败)。
</ResponseField>

<ResponseField name="video_url" type="string">
  视频下载地址(仅在 `completed` 状态下返回)。
</ResponseField>

<ResponseField name="status_update_time" type="integer">
  状态更新时间戳(Unix 时间戳)。
</ResponseField>

## 状态说明

| 状态           | 说明         |
| ------------ | ---------- |
| `processing` | 任务处理中      |
| `completed`  | 任务完成,可获取视频 |
| `failed`     | 任务失败       |

## 相关接口

* [Vidu 视频概览](./overview)
* [文生视频](./text2video)
* [图生视频](./img2video)
* [首尾帧生视频](./start-end2video)
* [参考生视频](./reference2video)
* [查询任务(统一视频)](./unified-query)