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

# Get video generation

> Seedance 2.0 GET /v1/video/generations/{task_id}

## Introduction

Poll task status and result by `task_id`. Query every **\~5 seconds**; generation usually completes in **30–120 seconds**.

Flow: `queued` → `in_progress` → `completed` / `failed`

## Authentication

<ParamField header="Authorization" type="string" required>
  Bearer Token, e.g. `Bearer sk-xxxxxxxxxx`
</ParamField>

## Path parameters

<ParamField path="task_id" type="string" required>
  `id` or `task_id` from the create response
</ParamField>

## Example

```bash theme={null}
curl -X GET "https://api.gravitex.ai/v1/video/generations/ut-abc123def456" \
  -H "Authorization: Bearer sk-xxxxxxxxxx"
```

## Status

| status        | Meaning                                                                                                                          |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `queued`      | Queued                                                                                                                           |
| `in_progress` | Generating; check `progress`                                                                                                     |
| `completed`   | Success; read `video_url` or `url`                                                                                               |
| `failed`      | See `error.message`; moderation failures: [Get moderation result](/en/api-reference/endpoint/seedance-2.0/get-moderation-result) |

## Response examples

**In progress:**

```json theme={null}
{
  "id": "ut-abc123def456",
  "task_id": "ut-abc123def456",
  "object": "video",
  "model": "seedance-2-0",
  "status": "in_progress",
  "progress": 50,
  "created_at": 1712563200
}
```

**Completed:**

```json theme={null}
{
  "id": "ut-abc123def456",
  "task_id": "ut-abc123def456",
  "status": "completed",
  "progress": 100,
  "video_url": "https://uptoken.cc/v1/media/proxy?...",
  "url": "https://uptoken.cc/v1/media/proxy?...",
  "created_at": 1712563200,
  "completed_at": 1712563320,
  "metadata": {
    "status": "succeeded",
    "usage": { "total_tokens": 97605 }
  }
}
```

**Failed:**

```json theme={null}
{
  "id": "ut-abc123def456",
  "status": "failed",
  "progress": 100,
  "error": {
    "message": "Content moderation failed",
    "code": "failed"
  }
}
```