> ## 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 개요

> Doubao Seedance 2.0 비디오 생성 및 자산 라이브러리

## 소개

Seedance 2.0은 텍스트-투-비디오, 이미지-투-비디오(첫/마지막 프레임), 멀티모달 참조 생성, 얼굴 일관성 자산 라이브러리를 지원합니다. Gravitex AI 게이트웨이를 통해 통합 호출, Base URL: `https://api.gravitex.ai`.

| 모델 ID               | 설명          | 해상도                            |
| ------------------- | ----------- | ------------------------------ |
| `seedance-2-0`      | 표준; 프로덕션 품질 | `480p`, `720p`, `1080p`        |
| `seedance-2-0-fast` | 빠른 반복       | `480p`, `720p` (**1080p 미지원**) |

## 인증

모든 엔드포인트: `Authorization: Bearer sk-xxxxxxxxxx`, `Content-Type: application/json`.

<Note>
  각 `asset://`를 자산 `asset_type`에 따라 `image_url`, `video_url`, `audio_url`에 매핑하세요—모두 `image_url`에 넣지 마세요. 자산은 공개 **https** URL로만 생성할 수 있습니다(Base64 / Data URI 미지원).
</Note>

## 자산 라이브러리 유형

| 라이브러리 | `group_type`    | 생성 방법                                                                                         |
| ----- | --------------- | --------------------------------------------------------------------------------------------- |
| 가상    | `aigc`          | [자산 그룹 생성](/ko/api-reference/endpoint/seedance-2.0/create-asset-group)                        |
| 실인물   | `liveness_face` | [자산 그룹 생성(실인물)](/ko/api-reference/endpoint/seedance-2.0/create-visual-validate-session) H5 검증 |

권장 흐름: 자산 그룹 생성 → [자산 생성](/ko/api-reference/endpoint/seedance-2.0/create-asset) → `status: active`까지 폴링 → [비디오 생성 작업 생성](/ko/api-reference/endpoint/seedance-2.0/create-video-generation) → [비디오 생성 작업 조회](/ko/api-reference/endpoint/seedance-2.0/get-video-generation).

## 엔드포인트

### 비디오 생성

<CardGroup cols={2}>
  <Card title="비디오 생성 작업 생성" icon="upload" href="/ko/api-reference/endpoint/seedance-2.0/create-video-generation">
    POST /v1/video/generations
  </Card>

  <Card title="비디오 생성 작업 조회" icon="search" href="/ko/api-reference/endpoint/seedance-2.0/get-video-generation">
    GET /v1/video/generations/{task_id}
  </Card>

  <Card title="검수 차단 사유 조회" icon="shield" href="/ko/api-reference/endpoint/seedance-2.0/get-moderation-result">
    GET /v1/video/generations/moderation-result/{task_id}
  </Card>
</CardGroup>

### 자산 라이브러리 (aigc)

<CardGroup cols={2}>
  <Card title="자산 그룹 생성" icon="folder-plus" href="/ko/api-reference/endpoint/seedance-2.0/create-asset-group">
    POST /v1/asset-groups
  </Card>

  <Card title="자산 그룹 목록 조회" icon="folders" href="/ko/api-reference/endpoint/seedance-2.0/list-asset-groups">
    GET /v1/asset-groups
  </Card>

  <Card title="자산 그룹 삭제" icon="trash" href="/ko/api-reference/endpoint/seedance-2.0/delete-asset-group">
    DELETE /v1/asset-groups/{group_id}
  </Card>

  <Card title="자산 생성" icon="file-plus" href="/ko/api-reference/endpoint/seedance-2.0/create-asset">
    POST /v1/assets
  </Card>

  <Card title="자산 목록 조회" icon="list" href="/ko/api-reference/endpoint/seedance-2.0/list-assets">
    GET /v1/assets
  </Card>

  <Card title="자산 조회" icon="file" href="/ko/api-reference/endpoint/seedance-2.0/get-asset">
    GET /v1/assets/{virtual_id}
  </Card>

  <Card title="자산 삭제" icon="file-minus" href="/ko/api-reference/endpoint/seedance-2.0/delete-asset">
    DELETE /v1/assets/{virtual_id}
  </Card>
</CardGroup>

### 실인물 얼굴 (liveness\_face)

<CardGroup cols={2}>
  <Card title="자산 그룹 생성(실인물)" icon="user-check" href="/ko/api-reference/endpoint/seedance-2.0/create-visual-validate-session">
    POST /v1/visual-validate/session
  </Card>
</CardGroup>

<Note>
  `POST /v1/visual-validate/result`는 H5 콜백 페이지 전용입니다. 애플리케이션에서 직접 호출하지 마세요.
</Note>

## 권장 흐름

1. (선택) 자산 그룹 생성 → 자산 생성 → `status: active`까지 폴링(보통 1\~3분)
2. `POST /v1/video/generations`
3. `GET /v1/video/generations/{task_id}` 약 5초마다 `completed`까지 폴링(보통 30\~120초)
4. 검수 `failed` 시 [검수 차단 사유 조회](/ko/api-reference/endpoint/seedance-2.0/get-moderation-result) 참조

[비디오 작업 제출](/ko/api-reference/endpoint/submit-video-task)도 참고하세요.

## 일반적인 HTTP 상태 코드

| 코드    | 의미        |
| ----- | --------- |
| `400` | 잘못된 매개변수  |
| `401` | 잘못된 API 키 |
| `402` | 잔액 부족     |
| `429` | 속도 제한     |
| `502` | 업스트림 오류   |

게이트웨이 검증 오류는 `error.type: invalid_request_error`를 사용합니다. BytePlus 오류는 `error.code`(예: `InvalidParameter`)와 `param` 필드 경로와 함께 전달됩니다.