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

# 비디오 생성 작업 조회

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

## 소개

`task_id`로 작업 상태와 결과를 폴링합니다. **약 5초**마다 조회하는 것을 권장합니다. 비디오 생성은 보통 **30\~120초** 내에 완료됩니다.

상태 흐름: `queued` → `in_progress` → `completed` / `failed`

## 인증

<ParamField header="Authorization" type="string" required>
  Bearer Token, 예: `Bearer sk-xxxxxxxxxx`
</ParamField>

## 경로 매개변수

<ParamField path="task_id" type="string" required>
  작업 생성 응답의 `id` 또는 `task_id`
</ParamField>

## 예제

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

## 상태

| status        | 의미                                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| `queued`      | 대기 중                                                                                                          |
| `in_progress` | 생성 중; `progress` 확인                                                                                           |
| `completed`   | 성공; `video_url` 또는 `url` 읽기                                                                                   |
| `failed`      | 실패; `error.message` 확인; 검수 실패 시: [검수 차단 사유 조회](/ko/api-reference/endpoint/seedance-2.0/get-moderation-result) |

## 응답 예제

**생성 중:**

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

**완료:**

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

**실패:**

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