# Query Video Generation Task

This file is the focused AI-readable context for one UniAll documentation page.

URL: https://docs.uniall.ai/models/video/sora-2/query-task
Locale: en
Markdown: https://docs.uniall.ai/ai/pages/models/video/sora-2/query-task.md
Description: Sora 2 query video generation task endpoint.

Agent guidance:
- Use this page when the user is asking about this specific route or model capability.
- Preserve endpoint paths, JSON keys, model IDs, and placeholder values exactly.
- Treat examples such as `sk-***`, `{BASE_URL}`, and `task_xxx` as safe placeholders, not real secrets.

## Page Markdown

## Endpoint


```http
GET /v1/videos/{task_id}
```
## Header Parameters

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `Authorization` | string | No | | Bearer {your_token} |
## Path Parameters

| Name | Type | Required | Description | Example |
| --- | --- | --- | --- | --- |
| `task_id` | string | Yes | | |
## Response Fields

| Field | Type | Required | Title | Description |
| --- | --- | --- | --- | --- |
| `id` | string | Yes | task ID | |
| `model` | string | Yes | Model name | |
| `object` | string | Yes | Task type | |
| `prompt` | string | Yes | prompt | |
| `status` | string | Yes | Status | queued:, in_progress: generation, completed: completed, failed: Failed |
| `duration` | string | Yes | task | |
| `metadata` | string | Yes | // | |
| `progress` | string | Yes | | |
| `video_url` | string | Yes | video URL | |
| `created_at` | string | Yes | Created time | |
| `thumbnail_url` | string | Yes | | |

## Response Examples

### Example 1

```json
{
  "id": "gen_xxxxxxx",
  "model": "sora2",
  "object": "video.generation.job",
  "prompt": "xxxxxxxxxxxxxx",
  "status": "completed",
  "duration": 89,
  "metadata": {
    "total_time": 89.550817778,
    "predict_time": 89.537048777
  },
  "progress": 100,
  "video_url": "https://xx.xxxxxx.cn/xxxx/xxxxxxxxxxxxxxxxxxxxxxxx.mp4",
  "created_at": 1770405484,
  "thumbnail_url": null
}
```