> ## 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 공식 미러 개요

> Seedance 공식 미러 API (BytePlus Ark 요청/응답과 완전히 동일)

## 소개

Seedance 공식 미러 API는 BytePlus Ark Seedance 공식 인터페이스와 **요청 본문 및 응답 본문이 완전히 동일**하며, Base URL과 인증 방식만 다릅니다. 기존 공식 SDK 호출 코드는 `base_url`과 `Authorization`만 변경하면 연동할 수 있습니다.

**Base URL**: `https://api.gravitex.ai`

| 모델 ID               | 설명                                  | 해상도                               |
| ------------------- | ----------------------------------- | --------------------------------- |
| `seedance-2-0`      | 표준 버전                               | `480p`, `720p`, `1080p`, `4K`     |
| `seedance-2-5`      | 차세대 멀티모달 모델; 비디오 생성·편집·연장 지원        | `seedance-2-0`과 동일                |
| `seedance-2-0-mini` | 가성비 버전; 생성 비용이 `seedance-2-0`의 약 절반 | `480p`, `720p` (`1080p`/`4K` 미지원) |
| `seedance-2-0-fast` | 빠른 버전                               | `480p`, `720p` (`1080p`/`4K` 미지원) |

<Note>
  이것은 플랫폼 간소화 인터페이스([`/v1/video/generations`](/ko/api-reference/endpoint/seedance-2.0/create-video-generation), [`/v1/assets`](/ko/api-reference/endpoint/seedance-2.0/create-asset) 등)와는 별도의 독립 인터페이스입니다. 자산 라이브러리 데이터는 공유되지만, 비디오 작업 라우팅은 서로 간섭하지 않습니다.
</Note>

## 인증

모든 인터페이스: `Authorization: Bearer sk-{your_token_key}`, `Content-Type: application/json`.

## 자산 라이브러리 유형

| 라이브러리 유형     | `GroupType`    | 생성 방법                                                                                                           |
| ------------ | -------------- | --------------------------------------------------------------------------------------------------------------- |
| 가상 자산 라이브러리  | `AIGC`         | [CreateAssetGroup](/ko/api-reference/endpoint/seedance-2.0-new/create-asset-group)                              |
| 실인물 자산 라이브러리 | `LivenessFace` | [CreateVisualValidateSession](/ko/api-reference/endpoint/seedance-2.0-new/create-visual-validate-session) H5 검증 |

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

## 엔드포인트 목록

### 비디오 생성 작업

<CardGroup cols={2}>
  <Card title="작업 생성" icon="upload" href="/ko/api-reference/endpoint/seedance-2.0-new/create-video-generation">
    POST /api/v3/contents/generations/tasks
  </Card>

  <Card title="작업 조회" icon="search" href="/ko/api-reference/endpoint/seedance-2.0-new/get-video-generation">
    GET /api/v3/contents/generations/tasks/{id}
  </Card>

  <Card title="작업 취소/삭제" icon="trash" href="/ko/api-reference/endpoint/seedance-2.0-new/delete-video-generation">
    DELETE /api/v3/contents/generations/tasks/{id}
  </Card>
</CardGroup>

### 자산 라이브러리 (통합 봉투 Action)

모든 자산 라이브러리 작업은 동일한 엔드포인트를 사용하며, `Action` 쿼리 매개변수로 구분합니다:

```
POST https://api.gravitex.ai/api/v3/seedance?Action=<Action명>&Version=2024-01-01
```

응답은 `{ ResponseMetadata, Result }` 봉투 형식입니다(실인물 검증 두 Action 제외, 평면 구조).

<CardGroup cols={2}>
  <Card title="CreateAssetGroup" icon="folder-plus" href="/ko/api-reference/endpoint/seedance-2.0-new/create-asset-group">
    자산 그룹 생성 (AIGC 강제)
  </Card>

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

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

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

  <Card title="GetAsset" icon="file" href="/ko/api-reference/endpoint/seedance-2.0-new/get-asset">
    단일 자산 조회
  </Card>

  <Card title="GetAssetGroup" icon="folder" href="/ko/api-reference/endpoint/seedance-2.0-new/get-asset-group">
    단일 자산 그룹 조회
  </Card>

  <Card title="UpdateAsset" icon="pen" href="/ko/api-reference/endpoint/seedance-2.0-new/update-asset">
    자산 업데이트 (Name)
  </Card>

  <Card title="UpdateAssetGroup" icon="pen-to-square" href="/ko/api-reference/endpoint/seedance-2.0-new/update-asset-group">
    자산 그룹 업데이트 (Name/Description)
  </Card>

  <Card title="DeleteAsset" icon="file-minus" href="/ko/api-reference/endpoint/seedance-2.0-new/delete-asset">
    자산 삭제
  </Card>

  <Card title="DeleteAssetGroup" icon="trash" href="/ko/api-reference/endpoint/seedance-2.0-new/delete-asset-group">
    자산 그룹 삭제 (연쇄)
  </Card>
</CardGroup>

### 실인물 자산 라이브러리 (LivenessFace)

<CardGroup cols={2}>
  <Card title="CreateVisualValidateSession" icon="user-check" href="/ko/api-reference/endpoint/seedance-2.0-new/create-visual-validate-session">
    실인물 검증 세션 시작
  </Card>

  <Card title="GetVisualValidateResult" icon="user" href="/ko/api-reference/endpoint/seedance-2.0-new/get-visual-validate-result">
    검증 결과 조회 및 자산 그룹 생성
  </Card>
</CardGroup>

## 권장 흐름

1. (선택) CreateAssetGroup → CreateAsset → `Status: Active`까지 폴링
2. `POST /api/v3/contents/generations/tasks`로 작업 제출
3. `GET /api/v3/contents/generations/tasks/{id}`로 `succeeded`까지 폴링
4. 필요 시 `DELETE`로 대기 중 작업 취소 또는 완료된 기록 정리

## 오류 처리

자산 라이브러리 오류는 봉투 `ResponseMetadata.Error.{Code,Message}`를 통해 반환됩니다:

| 시나리오                | HTTP  | `Error.Code`       |
| ------------------- | ----- | ------------------ |
| `Action`이 지원 목록에 없음 | `400` | `InvalidAction`    |
| 요청 본문이 유효한 JSON이 아님 | `400` | `InvalidParameter` |
| 사용 가능한 채널 없음        | `503` | `NoChannel`        |
| 할당량 확인 서버 오류        | `500` | `QuotaCheckFailed` |
| 자산 그룹 수 상한 초과       | `403` | `QuotaExceeded`    |
| 업스트림 호출 실패          | `502` | `UpstreamError`    |

비디오 생성 작업 API 오류는 해당 업스트림 상태 코드와 오류 본문을 반환합니다.