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

> Use `GET /v1/videos/{task_id}` to query Vidu video task status and results.

# Vidu Task Status Query

After submitting a Vidu series task, query it through `GET /v1/videos/{task_id}`.

* The query path is `GET /v1/videos/{task_id}`.
* A successful response returns an OpenAI-style `video` object.
* After the task is completed, you can read the result from `video_url`.

## Method and Path

```http theme={null}
GET /v1/videos/{task_id}
```

## Request Example

<CodeGroup>
  ```bash theme={null}
  curl https://octopusx.ai/v1/videos/video_123 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python theme={null}
  import requests

  resp = requests.get(
      "https://octopusx.ai/v1/videos/video_123",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      timeout=30,
  )
  print(resp.json())
  ```

  ```javascript theme={null}
  const response = await fetch("https://octopusx.ai/v1/videos/video_123", {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  });

  console.log(await response.json());
  ```
</CodeGroup>

## Response Example

<ResponseExample>
  ```json 200 - Processing theme={null}
  {
    "id": "video_123",
    "object": "video",
    "model": "viduq3-pro",
    "status": "processing",
    "progress": 50,
    "created_at": 1712697600,
    "size": "1024x1808",
    "seconds": "5",
    "quality": "standard"
  }
  ```

  ```json 200 - Completed theme={null}
  {
    "id": "video_123",
    "object": "video",
    "model": "viduq3-pro",
    "status": "completed",
    "progress": 100,
    "created_at": 1712697600,
    "completed_at": 1712697700,
    "size": "1024x1808",
    "seconds": "5",
    "quality": "standard",
    "video_url": "https://example.com/video/output.mp4"
  }
  ```

  ```json 200 - Failed theme={null}
  {
    "id": "video_123",
    "object": "video",
    "model": "viduq3-pro",
    "status": "failed",
    "progress": 0,
    "created_at": 1712697600,
    "completed_at": 1712697650,
    "size": "1024x1808",
    "error": {
      "message": "Generation failed, please try again",
      "code": "GENERATION_FAILED"
    }
  }
  ```
</ResponseExample>

## Authentication

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

## Path Parameters

<ParamField path="task_id" type="string" required>
  Task ID, which is the same as the `id` returned by the generation API.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Task ID.
</ResponseField>

<ResponseField name="object" type="string">
  Always `video`.
</ResponseField>

<ResponseField name="model" type="string">
  Model name.
</ResponseField>

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

<ResponseField name="progress" type="integer">
  Progress percentage (0-100).
</ResponseField>

<ResponseField name="created_at" type="integer">
  Creation time (Unix timestamp).
</ResponseField>

<ResponseField name="completed_at" type="integer">
  Completion time (Unix timestamp), returned only when the task is completed or failed.
</ResponseField>

<ResponseField name="size" type="string">
  Video size, for example `1024x1808`.
</ResponseField>

<ResponseField name="seconds" type="string">
  Video duration (seconds).
</ResponseField>

<ResponseField name="quality" type="string">
  Video quality, for example `standard`.
</ResponseField>

<ResponseField name="video_url" type="string">
  Video download URL, returned only in the `completed` status.
</ResponseField>

<ResponseField name="error" type="object">
  Error information, returned only in the `failed` status.
</ResponseField>

<ResponseField name="error.message" type="string">
  Error message.
</ResponseField>

<ResponseField name="error.code" type="string">
  Error code.
</ResponseField>

## Related APIs

* [Vidu Video Overview](./overview)
* [Vidu Video Generation](./vidu-generation)