> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 2.0 및 2.5
> Venice에서 Seedance 2.0 및 2.5로 비디오를 생성, 편집, 확장, 결합하세요. 텍스트, 이미지, 레퍼런스 기반 비디오 워크플로우, 공개 API 미디어 정책, 패밀리별 멀티모달 제한을 다룹니다.
Seedance는 텍스트, 이미지, 레퍼런스 기반 비디오 생성을 위한 Venice의 대표 멀티모달 비디오 패밀리입니다. **Seedance 2.0** (그리고 Fast)과 **Seedance 2.5**는 동일한 R2V 프롬프트 라우팅 모델을 공유합니다. 단일 reference-to-video 엔드포인트가 **네 가지 서로 다른 워크플로우** (Reference, Edit, Extend, Stitch)를 처리하며, 워크플로우는 **프롬프트의 형태**로부터 추론됩니다.
이 가이드에서는 변형, 네 가지 워크플로우, **공개 API 미디어 정책**, **패밀리별 멀티모달 제한**, 요금, `curl` 예제를 다룹니다.
**공개 Seedance API에서는 인물이 포함된 미디어가 지원되지 않습니다.** 공개 `*-basic` 모델은 동의 증명(`consents.seedance` / `needs_consent`)을 사용하지 않습니다. 이러한 입력은 콘텐츠 정책 또는 공급자 오류로 업스트림에서 거부될 수 있습니다. Seedance의 전체 기능 세트를 사용하려면 Venice 앱 또는 Studio를 이용하세요.
## 변형
| Model ID | 변형 | 출력 해상도 | 참고 |
| -------------------------------------------- | -------- | ---------------------------- | ------------------------------------------------------------------------------------ |
| `seedance-2-0-text-to-video-basic` | T2V | 480p / 720p / 1080p / **4k** | 텍스트 prompt 전용 |
| `seedance-2-0-image-to-video-basic` | I2V | 480p / 720p / 1080p / **4k** | 첫 프레임(선택적으로 마지막 프레임) 이미지 기반 |
| `seedance-2-0-reference-to-video-basic` | R2V | 480p / 720p / 1080p / **4k** | 최대 레퍼런스 이미지 9개 + 레퍼런스 비디오 3개 + 레퍼런스 오디오 도너 3개. Reference / Edit / Extend / Stitch 지원 |
| `seedance-2-0-fast-text-to-video-basic` | Fast T2V | 480p / 720p | 더 빠르고 낮은 품질의 티어(1080p / 4k 불가) |
| `seedance-2-0-fast-image-to-video-basic` | Fast I2V | 480p / 720p | 더 빠르고 낮은 품질의 티어(1080p / 4k 불가) |
| `seedance-2-0-fast-reference-to-video-basic` | Fast R2V | 480p / 720p | 더 빠르고 낮은 품질의 티어(1080p / 4k 불가). 동일한 워크플로우 세트 |
| `seedance-2-5-text-to-video-basic` | T2V | 480p / 720p | 최대 30초 출력, 네이티브 오디오 |
| `seedance-2-5-image-to-video-basic` | I2V | 480p / 720p | 최대 30초 출력, 첫 프레임(선택적으로 마지막 프레임) 기반 |
| `seedance-2-5-reference-to-video-basic` | R2V | 480p / 720p | 최대 이미지 30개 + 비디오 10개 + 오디오 도너 10개. 동일한 Reference / Edit / Extend / Stitch 워크플로우 |
모든 변형은 비동기입니다. `POST /api/v1/video/queue`로 제출한 뒤 응답 본문이 `video/mp4`가 될 때까지 `POST /api/v1/video/retrieve`를 폴링하세요. 일반 큐 흐름은 [Video Generation](/guides/media/video-generation)을 참고하세요.
`resolution`은 다음 중 하나로 전달하세요: `480p`, `720p`, `1080p` 또는 `4k`(소문자). Seedance **2.0**(non-Fast)은 네 가지 모두 허용합니다. **2.0 Fast**와 **2.5**는 `480p` / `720p`만 허용합니다. 실시간 모델 ID와 기능은 `GET /models?type=video`로 확인하며, 사용 가능 여부를 하드코딩하지 마세요.
## "하나의 모델, 네 가지 워크플로우" 모델
reference-to-video 변형(`seedance-2-0-reference-to-video-basic`, 그 Fast 형제, 그리고 `seedance-2-5-reference-to-video-basic`)은 동일한 프롬프트 라우팅 패턴을 사용합니다. **모델은 프롬프트 접두어와 입력의 형태로부터 작업을 추론합니다.** 별도의 `task`나 `workflow` 필드는 없으며, 프롬프트 문법 자체가 라우팅입니다.
| 워크플로우 | 기능 | 프롬프트 접두어 | 입력 |
| ------------- | ------------------------------------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------- |
| **Reference** | 업로드된 레퍼런스 파일을 subject / motion / style / audio의 도너로 사용하여 새로운 비디오 생성 | `Refer to ... in to generate ...` | 텍스트 + 이미지 또는 비디오 레퍼런스 1개 이상, 선택적 오디오 도너(개수는 패밀리에 따라 다름 — 제한 참고) |
| **Edit** | 단일 입력 비디오를 수정하되 나머지는 보존 | `Strictly edit , changing its ...` | 입력 비디오 1개 + 텍스트(이미지는 선택적 기반) |
| **Extend** | 클립 하나를 앞/뒤로 확장 | `Extend , generate ...` | 입력 비디오 1개 + 텍스트 |
| **Stitch** | 자동 생성된 전환 효과로 입력 클립을 이어붙임 | ` + + followed by + ...` | 여러 입력 비디오 + 텍스트(클립 개수/길이 제한은 패밀리별로 다름) |
**프롬프트 문법은 표준이며 대소문자를 구분합니다**: 꺾쇠 괄호, 첫 글자 대문자, 숫자 앞 공백 하나 — ``, ``, ``.
***
## 워크플로우 패턴
### Reference 워크플로우
업로드된 레퍼런스 파일을 **도너**(subject, scene, motion, style, vocal timbre)로 사용해 완전히 새로운 비디오를 생성합니다.
**표준 프롬프트 패턴**:
```
Refer to in to generate ...
Refer to the [action | camera scene | style | sound effect] in to generate ...
Refer to the [tone | timbre] in to generate ...
```
**예시**:
* `Refer to in to generate a 5-second clip of the same character riding a horse through snow.`
* `Refer to the camera scene in to generate a similar establishing shot of a futuristic city at dawn.`
* `Refer to in and use the timbre in for the narrator describing the scene.` (오디오 도너는 최소한 하나의 이미지 또는 비디오 레퍼런스와 함께 사용해야 하며, 오디오 단독은 거부됩니다)
### Edit 워크플로우
단일 입력 비디오를 수정합니다. **프롬프트에서 명시적으로 언급되지 않은 것은 보존됩니다.** 완전히 새로운 비디오가 아니라 국소적 변경(subject 교체, 날씨/색상 변경, 요소 추가/삭제)을 원할 때 사용하세요.
**표준 프롬프트 패턴**:
```
Strictly edit , changing its [original feature] to [new feature] ...
```
**세부 제어를 위한 하위 패턴**:
```
Add Elements:
At [timestamp / timing] and [spatial location] of , add [description of intended element].
Remove Elements:
Remove [element to be deleted] from , keeping the rest of the video content unchanged.
Modify Elements:
Replace [description of element to be changed] in with [description of intended element].
```
**예시**:
* `Strictly edit , changing its weather from sunny to a heavy rainstorm.`
* `Add snacks such as fried chicken and pizza to the countertop in .`
* `Remove the red car from , keeping the rest of the video content unchanged.`
* `Replace the perfume featured in with the face cream from , with all original motions and camera work preserved.`
마지막 예시는 Edit과 이미지 레퍼런스를 결합한 것으로, 완전히 유효합니다. 모델은 ``을 대체 요소의 시각적 도너로 사용합니다.
### 소스와 일치하는 종횡비 및 길이
Seedance reference-to-video **edit / extend**에서는 고정된 비율이나 길이를 지정하는 대신, 출력이 소스 클립을 따라가도록 요청할 수 있습니다:
| 필드 | 값 | 동작 |
| -------------- | -------------------- | ------------------------------------------------------------ |
| `aspect_ratio` | `adaptive` 또는 `auto` | 출력 종횡비가 소스 비디오와 일치 (Seedance 2.0 및 2.5 R2V) |
| `duration` | `-1` 또는 `auto` | 출력 길이가 소스 비디오와 일치 (Seedance **2.5** R2V edit; 소스는 4–30초여야 함) |
요구 사항:
* **Queue:** 소스와 일치하는 값을 사용하려면 `reference_video_urls`가 필요합니다.
* **Quote:** 소스와 일치하는 값을 사용하려면 `reference_video_total_duration`이 필요합니다. 소스와 일치하는 duration은 `ceil(reference_video_total_duration)`초로 청구됩니다.
* 종횡비와 길이는 독립적입니다 — 하나만 소스와 일치시키고 다른 하나는 지정할 수 있습니다.
* **Extend**의 경우, 고정된 `duration`(얼마나 생성할지)을 지정하고 선택적으로 `aspect_ratio: "adaptive"`를 사용하는 것이 좋습니다. 소스와 일치하는 `duration`은 "소스와 동일한 길이" edit 스타일 작업을 위한 것입니다.
### Extend 워크플로우
단일 클립을 시간적으로 앞이나 뒤로 이어갑니다. **기본적으로 Seedance는 새 콘텐츠만 반환하며**, 원본 입력에 확장분을 이어붙인 결과를 반환하지 않습니다. 이는 전환 연속성을 위한 의도적 설계입니다. 확장분과 함께 입력 클립을 보존하고 싶다면 명시적으로 지정하세요:
```
Extend , generate [description of extended content]
Extend backward, [description of extended content]
Extend , start with , then [description of extended content] ← 시작 부분에 입력 보존
Extend backward, [description], and then end with ← 끝 부분에 입력 보존
```
전환 처리: 모델이 자연스러운 블렌딩을 위해 전환 프레임을 자동으로 추출하며, 입력 비디오의 원본 세그먼트는 재생성되지 않습니다.
**예시**:
* `Extend , generate a dramatic chase scene through narrow alleys at dusk.`
* `Extend backward, the same character walking toward the camera before the original shot begins.`
* `Extend , start with , then the camera pulls back to reveal a vast landscape.`
### Stitch 워크플로우 (트랙 완성)
AI가 생성한 전환으로 입력 클립을 연결합니다. **패밀리별** 결합 길이 및 클립 수 제한을 [멀티모달 입력 제한](#multimodal-input-limits)에서 확인하세요 (Seedance 2.0: 클립 ≤3개 / 결합 ≤15초; Seedance 2.5: 더 높은 비디오 제한).
**표준 프롬프트 패턴**:
```
+ [transition description] + followed by [+ [transition description] + followed by ]
```
**예시**:
* ` + a smooth seamless cut + followed by `
* `. The moment a leaf falls to the ground, it sets off a special effect of golden particles. A gust of wind blows by, leading into .`
* ` + a wisp of smoke transforms into a flock of birds + followed by + a slow dolly-in + followed by `
모델은 연속성을 위해 연결 지점에서 세그먼트를 자동으로 트리밍합니다.
***
## 범용 프롬프트 공식
네 가지 워크플로우 모두에서 권장되는 작성 공식은 다음과 같습니다:
```
Subject + Motion + Environment (Optional)
+ Camera Movement / Cut (Optional)
+ Aesthetic Description (Optional)
+ Audio (Optional)
```
* **Subject + Motion**: 논리적 토대 — "누가" "어떤 행동"을 하는지 정의
* **Environment + Aesthetics**: 공간적 배경, 조명, 시각적 스타일
* **Camera**: 명시적 샷 유형 또는 움직임
* **Audio**: 몰입감 있는 출력을 위한 배경 효과음이나 음성 방향
이 공식을 워크플로우 접두어 위에 얹으면(예: `Strictly edit , changing its `) 최고 품질의 출력을 얻을 수 있습니다.
***
## 멀티모달 입력 제한
아래 값은 Venice API가 수용하는 범위입니다. 범위 밖의 요청은 추론에 도달하기 전에 스키마 계층에서 400으로 거부됩니다.
**Seedance 2.0과 Seedance 2.5는 서로 다른 제한을 사용합니다.** 호출 중인 모델 패밀리의 컬럼을 반드시 확인하세요.
### 공통 미디어 하한
| 제약 | 값 |
| --------------------- | ------------------------------------------------------------------- |
| 이미지 / 비디오 / 오디오 입력 방식 | URL (`http://`, `https://`) 또는 Base64 data URL |
| 이미지 형식 | `.jpeg`, `.png`, `.webp`, `.bmp`, `.tiff`, `.gif`, `.heic`, `.heif` |
| 이미지 종횡비 (W / H) | 배타적 `(0.4, 2.5)` |
| 이미지 최소 변 | ≥ 300 px |
| 비디오 형식 | `.mp4`, `.mov` |
| 비디오 코덱 | H.264 / AVC, H.265 / HEVC |
| 오디오 코덱(컨테이너 내) | AAC, MP3 |
| 오디오 형식(레퍼런스 오디오) | `.wav`, `.mp3` |
| 클립당 비디오 크기 | ≤ 50 MB |
| 클립당 오디오 크기 | ≤ 15 MB |
| I2V 첫 프레임 이미지 | 1 |
| I2V 첫 + 마지막 프레임 | 2 |
### 패밀리 비교
| 제약 | Seedance 2.0 (+ Fast) | Seedance 2.5 |
| ------------------- | --------------------------------------------------- | --------------- |
| 출력 길이 | 4–15 초 | 4–30 초 (기본값 10) |
| 출력 해상도 | 480p / 720p / 1080p / **4k** (Fast: 480p / 720p 전용) | 480p / 720p 전용 |
| R2V 레퍼런스 이미지 | 1–9 | 1–30 |
| 최대 R2V 레퍼런스 이미지 바이트 | (공통 요청 제한) | 이미지당 ≤ 30 MB |
| R2V 레퍼런스 비디오 | ≤ 3 | ≤ 10 |
| 레퍼런스 비디오당 길이 | `[2, 15]` 초 | `[2, 30]` 초 |
| 레퍼런스 비디오 결합 길이 | ≤ 15 초 | ≤ 30 초 |
| R2V 레퍼런스 오디오 클립 | ≤ 3 | ≤ 10 |
| 레퍼런스 오디오당 길이 | `[2, 15]` 초 | `[2, 30]` 초 |
| 레퍼런스 오디오 결합 길이 | ≤ 15 초 | ≤ 30 초 |
레퍼런스 오디오는 R2V 변형에서만 지원됩니다. 각 항목은 `role: "reference_audio"` 콘텐츠 항목으로 모델에 전달되며, 프롬프트에서는 ``, ``, … 로 참조합니다. 모델은 프롬프트가 어떻게 표현하는지에 따라 각 클립을 vocal timbre, 효과음 또는 배경 음악으로 사용합니다. 기존의 단수형 `audio_url` 필드는 동일한 콘텐츠 형태로 매핑되며, 이제 한 요소짜리 `reference_audio_urls`를 전달하는 것과 동일합니다.
**`reference_audio_urls`만을 유일한 레퍼런스 입력으로 사용할 수 없습니다.** 모델은 오디오 도너와 함께 최소한 하나의 이미지 또는 비디오 레퍼런스를 필요로 합니다. `reference_audio_urls`는 `reference_image_urls`, `reference_video_urls`, `image_url` 또는 `video_url`과 함께 사용하세요 — 오디오 전용 제출은 거부됩니다.
### 요청 크기
큐 엔드포인트는 최대 **35 MB**의 JSON 본문을 허용합니다. 큰 비디오의 인라인 data URL은 이를 넘길 수 있으므로 — 특히 다중 클립 Stitch의 경우 — 인라인 base64보다 URL 사용을 권장합니다.
***
## 요금
`/video/queue`에 제출하기 전에 주어진 요청 형태에 대한 견적을 얻으려면 `POST /api/v1/video/quote`를 호출하세요. quote 엔드포인트가 유일한 권위 있는 출처이며, 가격 세부 정보는 변경될 수 있으므로 클라이언트 측에 캐시하거나 중복 저장해서는 안 됩니다.
요청에 레퍼런스 비디오가 포함된 경우, quote가 `/video/queue`의 청구액과 일치하도록 `reference_video_total_duration`(모든 레퍼런스 클립 길이의 초 단위 합계)을 함께 전달하세요:
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"duration": "5s",
"resolution": "1080p",
"aspect_ratio": "16:9",
"reference_video_total_duration": 5
}'
```
소스와 일치하는 Seedance 2.5 edit quote(소스 길이 기준으로 청구):
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/quote \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"duration": "auto",
"resolution": "720p",
"aspect_ratio": "adaptive",
"reference_video_total_duration": 5.2
}'
```
***
## 전체 예제
모든 예제는 환경 변수 `VENICE_API_KEY`가 설정되어 있다고 가정합니다.
### Text-to-video
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-text-to-video-basic",
"prompt": "A golden retriever frolicking through a sunlit meadow at sunset, slow camera dolly-in, shallow depth of field, warm cinematic lighting.",
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
```
### Seedance 2.0 text-to-video (4K)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-text-to-video-basic",
"prompt": "Ultra-detailed aerial glide over a sunlit alpine lake, crystal water, distant peaks, cinematic color grade.",
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "4k"
}'
```
### Seedance 2.5 text-to-video (더 긴 길이)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-text-to-video-basic",
"prompt": "A slow aerial push over misty mountains at sunrise, clouds parting, soft orchestral ambience, cinematic widescreen framing.",
"duration": "20s",
"aspect_ratio": "16:9",
"resolution": "720p"
}'
```
### Image-to-video (첫 프레임)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-image-to-video-basic",
"prompt": "The lighthouse keeper turns toward the storm, lantern raised, waves crashing against the rocks.",
"image_url": "https://example.com/lighthouse.jpg",
"duration": "5s",
"resolution": "720p"
}'
```
Seedance I2V 모델(`seedance-2-0-image-to-video-basic`, 그 Fast 변형, `seedance-2-5-image-to-video-basic`)은 **`aspect_ratio`를 허용하지 않습니다** — 출력 종횡비는 입력 이미지의 크기에서 자동으로 도출됩니다. 이 필드를 전달하면 *"This model does not support aspect\_ratio"* 메시지와 함께 400이 반환됩니다. 명시적 종횡비 제어가 필요하면 T2V 또는 R2V 변형을 사용하세요.
### Reference 워크플로우 — subject 도너
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Refer to in to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night.",
"reference_image_urls": ["https://example.com/character.png"],
"duration": "5s",
"aspect_ratio": "9:16",
"resolution": "1080p"
}'
```
### Seedance 2.5 Reference 워크플로우 — 다중 이미지
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"prompt": "Refer to in and the style in to generate a 12-second clip of the same character exploring a rainy cyberpunk alley.",
"reference_image_urls": [
"https://example.com/character.png",
"https://example.com/style-board.png"
],
"duration": "12s",
"aspect_ratio": "9:16",
"resolution": "720p"
}'
```
### Reference 워크플로우 — subject + 오디오 도너
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Refer to in to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night. Refer to the timbre in for a soft female voiceover describing the scene.",
"reference_image_urls": ["https://example.com/character.png"],
"reference_audio_urls": ["https://example.com/voice-sample.mp3"],
"duration": "5s",
"aspect_ratio": "9:16",
"resolution": "1080p"
}'
```
### Edit 워크플로우
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Strictly edit , changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/sunny-scene.mp4"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Seedance 2.5 edit — 소스와 일치하는 duration 및 종횡비
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5-reference-to-video-basic",
"prompt": "Strictly edit , changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/sunny-scene.mp4"],
"duration": "auto",
"aspect_ratio": "adaptive",
"resolution": "720p"
}'
```
`duration: "auto"`(또는 `"-1"`)와 `aspect_ratio: "adaptive"`(또는 `"auto"`)를 사용하면 출력이 소스 클립을 따릅니다. [소스와 일치하는 종횡비 및 길이](#source-matched-aspect-ratio-and-duration)를 참고하세요.
### 이미지 기반이 있는 Edit 워크플로우
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Replace the perfume featured in with the face cream from , with all original motions and camera work preserved.",
"reference_video_urls": ["https://example.com/perfume-ad.mp4"],
"reference_image_urls": ["https://example.com/face-cream.png"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Extend 앞으로
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": "Extend , generate a dramatic chase scene through narrow alleys at dusk, with neon signs flickering and rain on the pavement.",
"reference_video_urls": ["https://example.com/alley-intro.mp4"],
"duration": "5s",
"aspect_ratio": "adaptive",
"resolution": "1080p"
}'
```
### Stitch (3 클립)
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/queue \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"prompt": " + a wisp of smoke transforms into a flock of birds + followed by + a slow dolly-in + followed by ",
"reference_video_urls": [
"https://example.com/clip-1.mp4",
"https://example.com/clip-2.mp4",
"https://example.com/clip-3.mp4"
],
"reference_video_total_duration": 12,
"duration": "5s",
"aspect_ratio": "16:9",
"resolution": "1080p"
}'
```
### 완료 폴링
큐에 제출할 때마다 반환된 `queue_id`를 저장하고, 응답 본문이 `video/mp4`가 될 때까지 `/video/retrieve`를 폴링하세요:
```bash theme={"system"}
curl -X POST https://api.venice.ai/api/v1/video/retrieve \
-H "Authorization: Bearer $VENICE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-0-reference-to-video-basic",
"queue_id": "123e4567-e89b-12d3-a456-426614174000"
}' \
-o output.mp4
```
작업이 완료될 때까지 응답은 JSON(`{ "status": "queued" | "running" | "failed", ... }`)이며, 완료 시 응답 본문이 `video/mp4` 바이트로 전환됩니다. 전체 폴링 패턴은 [Video Generation](/guides/media/video-generation)을 참고하세요.
***
## 문제 해결
### `At least one reference is required for this model`
reference-to-video 제출은 `reference_image_urls`, `reference_video_urls`, `image_references` 또는 `video_references` 중 최소 하나를 포함해야 합니다. 순수 텍스트 전용 생성은 유효한 R2V 워크플로우가 아니므로 text-to-video 모델 ID를 대신 사용하세요. `reference_audio_urls`만으로는 충분하지 않습니다(위 Audio 섹션 참고).
### 너무 많은 레퍼런스 비디오 / 이미지
Seedance **2.0**은 R2V를 **이미지 9개** 및 **비디오 3개**로 제한합니다. Seedance **2.5**는 이 제한을 **이미지 30개** 및 **비디오 10개**로 상향합니다. 패밀리 제한을 초과하면 입력을 정리하거나 오프라인에서 먼저 스티치하세요.
### 길이 / 결합 길이 오류
* **2.0:** 클립당 레퍼런스 비디오/오디오 `[2, 15]` 초; 결합 비디오/오디오 ≤ 15 초; 출력 4–15 초.
* **2.5:** 클립당 레퍼런스 비디오/오디오 `[2, 30]` 초; 결합 비디오/오디오 ≤ 30 초; 출력 4–30 초.
* **소스와 일치하는 duration** (Seedance 2.5의 `-1` / `auto`): 소스 클립은 4–30초여야 하며, `reference_video_urls`(queue) 또는 `reference_video_total_duration`(quote)이 필요합니다.
제출 전에 클라이언트 측에서 클립을 트리밍하세요.
### 프롬프트가 잘못된 워크플로우로 라우팅됨
워크플로우는 프롬프트 문법으로부터 추론됩니다. 흔한 잘못된 라우팅:
* **Extend**를 원하지만 `Refer to ...`로 작성 → 모델이 비디오를 이어갈 캔버스가 아닌 *도너*로 취급
* **Stitch**를 원하지만 `Refer to ...`로 작성 → 모델이 하나를 도너로 선택하고 나머지는 무시
* **Edit**을 원하지만 `Generate a video based on `으로 작성 → 모호함; 모델이 Reference로 기본 처리할 수 있음
표준 접두어를 다음과 같이 정확히 사용하세요: `Strictly edit , ...`, `Extend , ...`, ` + ... + followed by `.
### 인물이 포함된 미디어 미지원
공개 Seedance API 모델은 동의 증명 흐름(`consents.seedance` / `needs_consent`)을 실행하지 않습니다. 감지 가능한 인물이 포함된 미디어는 콘텐츠 정책 또는 공급자 오류로 실패할 수 있습니다. 대신 Venice 앱 또는 Studio를 사용하세요.
### 견적이 큐에 청구된 금액과 일치하지 않음
레퍼런스 비디오를 포함시켰지만 `/video/quote`에 `reference_video_total_duration`을 전달하지 않았다면, 견적과 큐 청구액이 다를 수 있습니다. 레퍼런스 비디오가 있는 경우 항상 `reference_video_total_duration`(모든 레퍼런스 클립 길이의 초 단위 합계)을 전달하세요.
***
## 참조
* Venice 비디오 큐 엔드포인트: [`POST /api/v1/video/queue`](/api-reference/endpoint/video/queue)
* Venice quote 엔드포인트: [`POST /api/v1/video/quote`](/api-reference/endpoint/video/quote)
* 관련 가이드: [Reference to Video](/guides/media/reference-to-video) (Kling O3 + Grok Imagine R2V를 다룸)
* 관련 가이드: [Video Generation](/guides/media/video-generation) (큐/폴링 개요)