> ## 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 Task Query

> Use `GET /vidu/ent/v2/task/{task_id}/creations` to query Vidu task status and results.

# Vidu Task Query

The official Vidu-format task query API is used to query the status and results of video generation tasks.

* The route entry is `GET /vidu/ent/v2/task/{task_id}/creations`.
* Specify the task to query through the path parameter `task_id`.
* Returns the task status (`processing`, `completed`, `failed`) and the video download URL.

## Method and Path

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

## Request Example

<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>

## Request Parameters

<ParamField path="task_id" type="string" required>
  Task ID. The `task_id` returned when the task was created.
</ParamField>

## Authentication

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

## Response Example

<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">
  Task ID.
</ResponseField>

<ResponseField name="status" type="string">
  Task status. Possible values: `processing` (in progress), `completed` (completed), `failed` (failed).
</ResponseField>

<ResponseField name="video_url" type="string">
  Video download URL (returned only when the status is `completed`).
</ResponseField>

<ResponseField name="status_update_time" type="integer">
  Status update timestamp (Unix timestamp).
</ResponseField>

## Status Description

| Status       | Description                     |
| ------------ | ------------------------------- |
| `processing` | Task is in progress             |
| `completed`  | Task completed, video available |
| `failed`     | Task failed                     |

## Related APIs

* [Vidu Video Overview](./overview)
* [Text to Video](./text2video)
* [Image to Video](./img2video)
* [Start-End Frame to Video](./start-end2video)
* [Reference to Video](./reference2video)
* [Query Task (Unified Video)](./unified-query)