> ## 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.5 안내

> model: seedance-2-5 — Seedance 2.0과의 API 차이점

## 소개

Seedance 2.5(`model: "seedance-2-5"`)는 Seedance 2.0과 동일한 엔드포인트(Base URL, 인증, 자산 라이브러리, 작업 조회, 응답 형식 모두 동일)를 공유합니다. [비디오 생성 작업 생성](/ko/api-reference/endpoint/seedance-2.0/create-video-generation) 시 `model`을 `seedance-2-5`로 바꾸기만 하면 호출할 수 있습니다. 이 페이지에는 **2.5가 2.0과 다른 점만** 정리되어 있습니다. 여기에 언급되지 않은 부분(인증, 자산 라이브러리, 폴링, 오류 코드 등)은 2.0과 완전히 동일하며 아래 문서를 참고하세요:

* [비디오 생성 작업 생성](/ko/api-reference/endpoint/seedance-2.0/create-video-generation)(기본 파라미터, `content` 배열 구조, 상호 배타 규칙)
* [비디오 생성 작업 조회](/ko/api-reference/endpoint/seedance-2.0/get-video-generation)
* [자산 그룹 생성](/ko/api-reference/endpoint/seedance-2.0/create-asset-group) / [자산 생성](/ko/api-reference/endpoint/seedance-2.0/create-asset)
* [검수 차단 사유 조회](/ko/api-reference/endpoint/seedance-2.0/get-moderation-result)

## 주요 차이점

| 항목                       | Seedance 2.0                     | Seedance 2.5              |
| ------------------------ | -------------------------------- | ------------------------- |
| `duration`               | `-1` 또는 `4`\~`15`초               | `-1` 또는 `4`\~`30`초        |
| 참조 이미지 `reference_image` | 최대 9개                            | 최대 30개                    |
| 참조 비디오 `reference_video` | 최대 3개, 총 길이 ≤ 15초                | 최대 10개                    |
| 참조 오디오 `reference_audio` | 최대 3개                            | 최대 10개                    |
| 비디오 편집 / 비디오 연장          | 미지원                              | 지원, 아래 "규칙" 참고            |
| `output_format`          | `mp4` 고정                         | `mov` 선택 가능(신규)           |
| `resolution`(현재 지원)      | `480p` / `720p` / `1080p` / `4K` | `480p` / `720p` / `1080p` |

<Note>
  참조 자산 수량 상한 및 시간 상한 확대는 Seedance 2.5 업스트림 모델의 기능입니다. 자세한 내용은 [Dreamina Seedance 2.5 tutorial](https://docs.byteplus.com/en/docs/ModelArk/2607688)을 참고하세요. `duration`과 참조 자산 수량 제한은 이미 업스트림을 따라 확대되었으며, `resolution` 과금 등급은 위 표 및 실제 주문 페이지 기준입니다.
</Note>

## 규칙

Seedance 2.5에는 별도의 작업 유형 파라미터가 없습니다. 대신 `content`에 포함된 미디어 자산의 `role`과 프롬프트에 담긴 의도를 바탕으로 요청이 아래 표 중 어떤 작업에 해당하는지 자동으로 판별합니다. 작업 유형에 따라 `ratio`, `duration`의 허용 범위도 달라집니다:

| 작업 유형               | 트리거 조건                                                                                    | `ratio`             | `duration`        |
| ------------------- | ----------------------------------------------------------------------------------------- | ------------------- | ----------------- |
| 텍스트-투-비디오           | 참조 자산이 전혀 없고 텍스트 프롬프트만 있음                                                                 | 특정 비율 또는 `adaptive` | `-1` 또는 `4`\~`30` |
| 참조 비디오 생성           | `reference_image`, `reference_video`, `reference_audio` 중 하나 이상을 제공하고, 프롬프트에 편집/연장 의도가 없음 | 특정 비율 또는 `adaptive` | `-1` 또는 `4`\~`30` |
| 비디오 편집              | 참조 자산을 제공하고, 프롬프트에 추가·삭제·교체·수정·리페인트·복원 등 편집 의도가 있음                                        | 반드시 `adaptive`      | 반드시 `-1`          |
| 비디오 연장              | 참조 자산을 제공하고, 프롬프트에 앞/뒤로 연장·이어서·계속 등 연장 의도가 있음                                             | 반드시 `adaptive`      | `-1` 또는 `4`\~`30` |
| 첫 프레임/첫-마지막 프레임 비디오 | 이미지를 `first_frame`으로 제공, `last_frame`을 함께 제공 가능                                           | 반드시 `adaptive`      | `-1` 또는 `4`\~`30` |

## 요청 예제(표준 텍스트-투-비디오 / 이미지-투-비디오)

2.0과 사용법이 완전히 동일하며 `model`만 교체하면 됩니다:

```bash theme={null}
curl -X POST "https://api.gravitex.ai/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "content": [
      {"type": "text", "text": "Golden hour drone shot over rolling mountains, clouds rolling by"}
    ],
    "duration": 20,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'
```

파라미터 설명, `content` 배열 구조, 자산 `asset://` 매핑 규칙 등은 [비디오 생성 작업 생성](/ko/api-reference/endpoint/seedance-2.0/create-video-generation)을 참고하세요.

다음 단계: [비디오 생성 작업 조회](/ko/api-reference/endpoint/seedance-2.0/get-video-generation)