> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedance 2.0 동영상 생성
> 공식 Volcengine 리소스를 통해 제공되는 바이트댄스 Seedance 2.0: 표준 / 빠른 / mini (Lite) 모델을 병렬로, 텍스트-투-동영상, 첫+마지막/첫 프레임, 멀티모달 참조-투-동영상. 각 티어별로 모든 화면 비율이 동일한 가격이며, 기본으로 동기화된 오디오가 제공되고, 대기열 없이 높은 동시 실행 수를 지원합니다.
## 개요
**doubao-seedance-2-0-260128** (표준), **doubao-seedance-2-0-fast-260128** (빠른), 그리고 **doubao-seedance-2-0-mini-260615** (mini/lite)은 ByteDance의 최신 동영상 생성 모델군으로, 세 모델이 병렬로 운영되며 공식 Volcengine 중국 본토 리소스를 통해 APIYI에서 제공됩니다( BytePlus 국제판이 아닙니다). 상위단 콘텐츠 안전 기능이 내장되어 있습니다. 텍스트-투-비디오, 첫+마지막/첫 프레임 이미지-투-비디오, 그리고 멀티모달 입력(참조 이미지 0-9개 + 참조 동영상 0-3개 / 참조 오디오 0-3개)을 지원하며, 음성, 효과음, 배경 음악을 영상과 동기화해 생성할 수 있습니다. 2026년 6월에 추가된 Mini는 비용 효율성이 가장 높은 선택으로, **표준 모델 단가의 약 절반이면서 생성 속도도 더 빠르고**, 최대 720p로 제한됩니다.
**🎬 주요 특징**: 4-15초 조절 가능한 지속 시간(또는 `-1`의 모델 선택 길이), 세 가지 해상도 단계(480p/720p/1080p; 1080p는 표준 모델만 지원), 6개 화면비와 적응형, **동기화 오디오 기본 활성화**, 그리고 다국어 prompt(중국어, 영어, 일본어, 스페인어, 포르투갈어, 인도네시아어). **숏폼 영상 제작, 이커머스 소재, 모션 디자인, 가상 휴먼 콘텐츠**를 대규모로 제작하도록 설계되었습니다.
`POST /seedance/api/v3/contents/generations/tasks` — 대화형 Playground와 전체 폴링/다운로드 코드가 포함된 비동기 작업 엔드포인트입니다.
token 생성, 기본 URL, 과금 방식, 일반 호출 규칙입니다.
iCover 시각적 테스트 도구에서 이 엔드포인트를 직접 디버그하세요 — 코드가 필요 없습니다.
제출한 동영상 작업을 보고 APIYI 콘솔에서 동영상 링크를 다운로드할 수 있습니다 — API 밖의 조회 항목입니다.
## 왜 APIYI의 Seedance 2.0인가요?
먼저 포지셔닝에 대한 메모입니다. 이 모델에는 **공식 할인은 없고, APIYI도 이 모델을 수익 목적으로 가격 책정하지 않습니다** — **공급을 안정적으로 확보하고 고객을 서비스하기 위해** 제공합니다. APIYI를 통해 이용할 때의 진짜 가치는 "더 저렴함"이 아니라 접근성과 경험입니다:
공식 Volcengine 중국 본토 리소스(BytePlus 해외판이 아님)이며, upstream 콘텐츠 안전성이 내장되어 있습니다. 파라미터, 응답, 과금은 공식 API와 정확히 일치합니다.
테스트에서 동시에 15개의 작업이 모두 `running`에 즉시 진입했으며 대기열은 전혀 없었습니다(2026-06-06 (UTC+8) 측정) — 대규모 배치 생산에 바로 사용할 수 있습니다.
공식 할인은 없고 APIYI는 이 모델에서 수익을 남기지 않습니다. 단가 는 Volcengine의 공식 요금표와 맞춰져 있으며(플랫폼 내 과금은 대략 10% 더 높음), [충전 보너스](/ko/faq/recharge-promotions)를 함께 적용하면 실효 비용은 **공식 채널과 거의 같은 수준**이며, 고액 충전 고객은 일부 구간에서 그보다 더 낮아질 수 있습니다.
**Volcengine 계정 없음, 실명/신원 인증 없음, 지출 기준 없음**(CNY 200 활성화 보증금과 기업 인증 생략). 중국 본토 데이터 센터, 가정용 네트워크, 해외 노드 모두 단일 token으로 `api.apiyi.com`에 직접 접속할 수 있습니다.
이 채널에는 upstream의 **가상 얼굴 화이트리스트** 접근 권한이 포함되어 있습니다. AI가 생성한 얼굴과 가상 아바타를 image-to-video에 바로 사용할 수 있으며, 공식 채널에 별도로 화이트리스트를 신청할 필요가 없습니다(실제 사람 얼굴은 upstream 콘텐츠 안전성에 의해 계속 제한됩니다).
[VEO 3.1](/ko/api-capabilities/veo-3-1-official/overview), [Sora 2](/ko/api-capabilities/sora-2/overview), [Wan2.7](/ko/api-capabilities/wan/overview)을 같은 플랫폼에서 이용할 수 있습니다. 사용 사례에 따라 자유롭게 조합해 사용하십시오.
동영상 생성 워크로드 경험이 있는 팀이 PoC부터 운영 단계까지 모델 선택, 튜닝, 통합을 지원합니다.
## 주요 기능
480p / 720p / 1080p (1080p 표준 모델만 해당). 한 단계 내에서는 16:9, 9:16, 1:1 및 그 외 모든 비율이 **동일한 픽셀 면적과 동일한 가격**을 공유합니다. 가로와 세로를 전환해도 추가 비용이 들지 않습니다.
`generate_audio`의 기본값은 true입니다. 음성, 음향 효과, 배경 음악이 시각 요소에 맞게 생성됩니다. 음성 해설 품질을 높이려면 대사를 큰따옴표로 감싸십시오.
`duration`은 4초에서 15초 사이의 정수 초를 받거나 `-1`으로 모델이 길이를 정하도록 할 수 있습니다(실제 출력 기준 과금). 24 fps 고정입니다.
중국어(최대 약 500자)와 영어(최대 약 1000단어), 그리고 일본어, 스페인어, 포르투갈어, 인도네시아어를 지원합니다.
두 이미지를 사용해 첫 프레임과 마지막 프레임을 모두 고정하거나, 단일 이미지를 첫 프레임으로 애니메이션할 수 있습니다. `return_last_frame`과 결합하면 클립을 이어 더 긴 연속 동영상으로 만들 수 있습니다.
0-9개의 참조 이미지와 0-3개의 참조 동영상, 0-3개의 참조 오디오를 섞어(최소 1개의 이미지 또는 1개의 동영상 필요; 세 가지 이미지 모드는 서로 배타적입니다) 캐릭터와 스타일의 일관성을 유지하면서 동영상을 생성, 편집 또는 확장할 수 있습니다.
제출하면 `task_id`를 받고, 상태를 폴링한 다음 `content.video_url`에서 mp4를 다운로드합니다(링크는 24시간 동안 유효합니다).
`seed`을 고정하면 실행 간 유사한 결과를 얻을 수 있습니다. `watermark`의 기본값은 false이며, 출력에는 워터마크가 없습니다.
## 요금
**한 줄 요약 — 정확한 token 과금이며, Volcengine 공식 사이트 기준으로 티어별로 연동됩니다.** 세 모델은 **가격이 서로 다릅니다**: mini \< fast \< standard (공식 사이트와 같은 방향입니다. mini는 standard 모델 단가의 약 절반 수준이며 — **같은 가격대가 아닙니다**). 플랫폼 내 정가는 공식 정가의 약 **1.1배**이며, [충전 보너스](/ko/faq/recharge-promotions)(일반 고객 10%, 대량 입금 고객 최대 20%)를 적용하면 실효 비용은 **사실상 공식 사이트와 같은 수준**입니다. 일부 티어에서는(예: 1080p 대형 고객 가격) 더 낮기도 합니다. 과금은 면적×길이 기준이므로 **±5% 편차는 정상**입니다 — 직접 테스트하고 대조해 보신 뒤 언제든 문의해 주셔도 됩니다.
Token 기준 과금: `tokens ≈ (input video duration + output duration)(s) × output width × output height × 24 / 1024` (텍스트-/이미지-to-video의 경우 입력 video 길이는 0입니다. 당사 테스트에서 0.1% 이내로 검증되었습니다). 티어 내 모든 비율은 같은 픽셀 면적을 가지므로, **가격은 해상도 티어, 출력 길이, 입력에 video가 포함되는지 여부에만 좌우됩니다.**
### 공식 가격 기준 (16:9 / 5초 출력, 동영상당 CNY)
**① 입력 동영상 없음** (텍스트-투-동영상 / 이미지-투-동영상 / 참조 이미지):
| 해상도 | Standard `doubao-seedance-2.0` | Fast | Mini |
| ----- | ------------------------------ | -------- | -------- |
| 480p | CNY 2.31 | CNY 1.86 | CNY 1.16 |
| 720p | CNY 4.97 | CNY 4.00 | CNY 2.50 |
| 1080p | CNY 12.39 | 지원되지 않음 | 지원되지 않음 |
**② 입력 동영상 포함** (`video_url`를 포함한 멀티모달 참조; 입력 동영상 2-15초, 하한 ≈ 입력 2-4초, 상한 ≈ 입력 15초):
| 해상도 | Standard `doubao-seedance-2.0` | Fast | Mini |
| ----- | ------------------------------ | --------------- | --------------- |
| 480p | CNY 2.53 - 5.62 | CNY 1.99 - 4.42 | CNY 1.28 - 2.84 |
| 720p | CNY 5.44 - 12.10 | CNY 4.28 - 9.50 | CNY 2.74 - 6.10 |
| 1080p | CNY 13.56 - 30.13 | 지원되지 않음 | 지원되지 않음 |
입력 동영상이 있는 경우 청구되는 지속 시간 = **입력 동영상 지속 시간 + 출력 지속 시간**이므로, 일반적인 텍스트-/이미지-투-동영상보다 더 비쌉니다. 최소 token 하한도 적용됩니다(매우 짧은 입력은 하한으로 청구됩니다). 권위 있는 사용량은 반환된 `usage.completion_tokens`입니다.
**플랫폼 내 측정 비교** (2026-06 및 2026-07 테스트, 16:9 / 기본 오디오 / 입력 동영상 없음; 고정 1:7 환율 기준 CNY, 참고용):
| 모델 | 해상도 | 지속 시간 | APIYI 비용 | CNY | 일반 ÷1.1 (¥) | 대형 고객 ÷1.2 (¥) | 공식 기준 (¥) |
| --------------------------------- | ----- | ----- | -------- | ------ | ----------- | -------------- | --------- |
| `doubao-seedance-2-0-fast-260128` | 720p | 5s | \$0.7253 | ¥5.08 | ¥4.62 | ¥4.23 | ¥4.00 |
| `doubao-seedance-2-0-fast-260128` | 480p | 5s | \$0.3373 | ¥2.36 | ¥2.15 | ¥1.97 | ¥1.86 |
| `doubao-seedance-2-0-260128` | 720p | 5s | \$0.9074 | ¥6.35 | ¥5.77 | ¥5.29 | ¥4.97 |
| `doubao-seedance-2-0-260128` | 480p | 5s | \$0.4193 | ¥2.94 | ¥2.67 | ¥2.45 | ¥2.31 |
| `doubao-seedance-2-0-260128` | 1080p | 5s | \$2.0288 | ¥14.20 | ¥12.91 | ¥11.84 | ¥12.39 |
| `doubao-seedance-2-0-fast-260128` | 720p | 4s | \$0.5814 | ¥4.07 | ¥3.70 | ¥3.39 | ¥3.20 |
| `doubao-seedance-2-0-fast-260128` | 720p | 8s | \$1.1568 | ¥8.10 | ¥7.36 | ¥6.75 | ¥6.40 |
| `doubao-seedance-2-0-mini-260615` | 720p | 5s | \$0.4508 | ¥3.16 | ¥2.87 | ¥2.63 | ¥2.50 |
| `doubao-seedance-2-0-mini-260615` | 480p | 4s | \$0.1681 | ¥1.18 | ¥1.07 | ¥0.98 | ¥0.93 |
| `doubao-seedance-2-0-mini-260615` | 720p | 15s | \$1.3451 | ¥9.42 | ¥8.56 | ¥7.85 | ¥7.47 |
**세 모델은 가격이 같지 않습니다 — 절대 동일하게 취급하지 마십시오.** 같은 해상도/지속 시간에서도 token당 가격은 mini \< fast \< standard 순입니다(예: 720p/5s: mini ≈ ¥3.16, fast ≈ ¥5.08, standard ≈ ¥6.35). 이는 공식 가격 체계와 일치합니다. 대량 제작에서는 mini가 **가장 많은 비용과 시간을 절약합니다**(2026-07 테스트에서 유효 단가가 플랫폼의 명목 요율과 정확히 일치했으며, 편차는 0.00%였습니다). 1080p는 standard에서만 지원됩니다.
참고: "CNY"는 플랫폼 내 고시 가격이며, "General ÷1.1"과 "Large customer ÷1.2"는 10% / 20% [충전 보너스](/ko/faq/recharge-promotions) 이후의 유효 가격입니다. 보너스 적용 후 가격은 공식 기준에 가깝게 형성되며, 1080p 대형 고객 가격은 공식보다 더 낮습니다. 권위 있는 사용량은 반환된 `usage.completion_tokens`입니다.
**과금 참고 사항**:
* 최종 청구는 콘솔의 모델 과금과 호출 로그를 따릅니다
* **작업은 제출 시 선청구되고 완료 시 정산됩니다** — 잔액이 잠시 변동하며, 호출 로그와 대조해야 합니다. 동영상 하나당 **두 개**의 청구 항목이 생성됩니다(아래 “로그에서 청구 내역 읽기” 참조)
* 거부된 요청(HTTP 400 매개변수 오류 등)은 **과금되지 않습니다**(검증됨)
* 비용은 지속 시간에 비례합니다. 15초 동영상은 5초 동영상의 약 3배입니다
### 로그에서 과금 읽기 (사전 과금 + 정산)
`api.apiyi.com/log`의 콘솔 로그 페이지를 열고 모델 이름 `doubao-seedance-2-0`을 검색하면 모든 과금 내역을 볼 수 있습니다. **비디오 하나는 과금 항목을 2개 생성합니다**:
1. **사전 과금**: 작업이 제출될 때 차감되는 추정 금액입니다(“비스트리밍”으로 표시된 로그 항목이며, token과 그룹을 보여줍니다) — 아래 스크린샷에서는 \$0.449998입니다
2. **정산(과금 또는 환불)**: 작업이 완료된 뒤 실제 생성된 tokens를 기준으로 차액을 정산합니다(“streaming”으로 표시된 로그 항목이며, completion-token 수가 있습니다) — 아래에서는 \$5.611858입니다; **1080p는 보통 추가 과금이 발생합니다**
정산 항목에는 **token도 그 그룹도 표시되지 않습니다** — 이는 정상입니다. 두 항목의 합이 비디오의 총 비용입니다.
**시간 필드를 읽는 방법**:
1. 첫 번째 항목(사전 과금)의 타임스탬프는 비디오의 **제출 시간**입니다. 그 “first byte” 값은 제출이 task ID를 반환하는 데 걸린 시간입니다(예: `首字节:3秒` / first byte: 3 s) — 생성 시간이 **아닙니다**
2. 정산 항목에는 `流式`(streaming)와 `首字节:<1秒`(1초 미만의 first byte)가 표시됩니다 — 이는 정산 기록의 내부 표식일 뿐이며, **문제가 있다는 신호가 아닙니다**
3. 비디오의 실제 **생성 시간**은 상단 내비게이션의 “Async tasks” 페이지(`api.apiyi.com/task`)에 있는 “耗时” (elapsed) 열입니다
첫 번째 스크린샷의 15 s 1080p 비디오는 총 비용이 0.449998 + 5.611858 = **\$6.061856**입니다. 일치하는 작업 매개변수는 `api.apiyi.com/task` 상단의 “Async tasks” 아래에서 확인할 수 있으며, 과금과 정확히 일치합니다:
```json theme={null}
{
"id": "cgt-20260703185641-9nbbg",
"model": "doubao-seedance-2-0-260128",
"status": "succeeded",
"duration": 15,
"resolution": "1080p",
"ratio": "3:4",
"framespersecond": 24,
"generate_audio": true
}
```
732,108 completion tokens ≈ 15 × 1248 × 1664 × 24 / 1024 (1080p의 3:4 비디오는 1248×1664를 출력합니다) — 과금 공식과 일치합니다.
이 15 s 1080p 비디오는 총 약 **¥42.4**입니다(고정 1:7 비율의 명목상 과금 기준). [충전 보너스](/ko/faq/recharge-promotions)를 적용하면 실질 비용은 대략 ¥35-39이며, 같은 사양의 공식 기준 약 ¥37.2와 비교할 수 있습니다. **공식 가격 자체도 저렴하지 않습니다** — 비용은 **model + 해상도 + 지속 시간**에 의해 결정됩니다(빠른 / 720p / 5 s로 바꾸면 훨씬 저렴합니다). 이 모델은 공급을 확보하기 위해 낮은 마진으로 제공되며, 대규모 충전 고객은 더 큰 할인을 받습니다.
**베타 공급 안내**: Seedance 2.0은 현재 베타 공급 단계입니다. 실제 과금이 위 표와 눈에 띄게 다르면 고객 지원에 문의해 주시면 정산하겠습니다. 과금은 상위 정책(예: 나중에 더 저렴한 공식 변형이 출시되는 경우)과 APIYI의 공급 능력에 따라 동적으로 조정되며, 역량 있는 채널 파트너의 문의도 환영합니다. 이 모델은 수익이 아니라 공급 확보와 고객 서비스를 위해 가격이 책정되었습니다.
## 그룹 설정
Seedance 2.0은 전용 **`SeeDance2` 그룹**에서 실행됩니다(0.18x 요율, CNY 기준). 다만 두 가지 **엄격한 필수 조건**이 있습니다. ① Token의 과금 모델은 **종량제 우선순위**(또는 종량제)여야 하며 — 요청당 과금 tokens는 라우팅할 수 없습니다; ② Token에 **`SeeDance2` 그룹**이 활성화되어 있어야 합니다. 기본 그룹이나 다른 동영상 그룹의 Token은 "**이 모델에 사용할 수 있는 채널이 없습니다**" 오류로 실패합니다.
| 그룹 | 요율 | 사용 시점 |
| ----------- | ----- | ----------------------------------------------- |
| `SeeDance2` | 0.18x | Seedance 2.0을 제공하는 유일한 그룹 — 충분한 동시 실행 수, 대기열 없음 |
**왜 0.18x입니까?** Seedance 2.0의 시스템 내장 단가는 Volcengine의 공식 리스트 가격과 일치합니다. 다만 해당 리스트는 **CNY** 기준이고, APIYI 잔액은 **USD** 기준입니다(USD/CNY 고정 1:7 환율). 1x 요율이면 사실상 공식 금액의 7배를 청구하게 되므로, 환전 효과를 흡수하기 위해 그룹 요율을 낮췄습니다. **0.18 × 7 = 1.26**이므로, 명목 과금은 공식 CNY 가격의 약 1.26배입니다. [충전 보너스](/ko/faq/recharge-promotions)를 더하면 일반 사용자는 공식 가격보다 약 10% 높게 지불하고, 고액 충전 고객은 그 수준과 같거나 더 낮아집니다(예: 1080p 등급).
**유의하시기 바랍니다**: 과금은 항상 **실제 token 사용량**을 기준으로 하며, token 환산에는 작은 자연 변동(±5%는 정상)이 있습니다. 공식 리스트 가격은 단지 **참조 기준**일 뿐, 요청당 보장이 아닙니다. 현재 요금은 공급 우선에 따른 합리적인 구성입니다 — 항상 **충전 보너스와 함께** 평가하십시오. 과금이 이상해 보이면 언제든지 함께 과금 내역을 대조해 드리겠습니다. 다만 "왜 공식 가격보다 약간 높은가"는 논의 대상이 아니니 이 점을 유념하시고, 이 부분이 우려된다면 이 채널은 건너뛰십시오. 반대로, **충분한 동시 실행 수와 대기열 없음**이야말로 이 채널이 제공하는 가치입니다.
권장하는 두 가지 Token 구성:
| 구성 | 가장 적합한 경우 | 방법 |
| ------------------ | ----------------- | --------------------------------------------------------------------- |
| **A. 공유 Token 1개** | 개인 프로젝트, 혼합 모델 사용 | 기존 Token의 그룹 목록에 \*\*`SeeDance2`\*\*을 추가하십시오; 과금 모델은 종량제 우선순위로 유지하십시오 |
| **B. 전용 Token** | 프로덕션 워크로드, 분리된 과금 | 오직 `SeeDance2` 그룹만 포함한 Token을 생성하십시오 — 더 깔끔한 리포팅, 사업 부문별 쿼터 알림 |
프로덕션 환경에서는 \*\*B(전용 Token)\*\*를 권장합니다: 깔끔한 과금, 사업 부문별 쿼터 제어, 사용량이 급증할 때 더 쉬운 문제 해결이 가능합니다.
## 기술 사양
| 항목 | 값 |
| -------------- | ------------------------------------------------------------------------------------------------------------------- |
| **모델** | `doubao-seedance-2-0-260128` (표준) / `doubao-seedance-2-0-fast-260128` (빠름) / `doubao-seedance-2-0-mini-260615` (미니) |
| **해상도** | 480p / 720p / 1080p (1080p는 표준만 지원하며, 빠름과 미니는 720p로 제한됨) |
| **종횡비** | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive` (기본값은 적응형) |
| **길이** | 4-15초 정수, 또는 `-1` 모델이 선택함(기본값 5) |
| **프레임 속도** | 고정 24 fps (`frames` 매개변수는 지원되지 않음) |
| **오디오** | `generate_audio`의 기본값은 `true`입니다; 모노 |
| **입력 이미지** | jpeg/png/webp/bmp/tiff/gif/heic/heif; 종횡비 (0.4, 2.5); 변 길이 (300, 6000) px; 각 30 MB 미만 |
| **입력 동영상/오디오** | Seedance 2.0만 지원; 오디오 wav/mp3, 클립당 2-15초, 최대 3개 클립, 이미지 또는 동영상과 함께 제공해야 함 |
| **생성 시간(측정값)** | 720p에서 5초: 약 2-5분; 1080p: 약 3분; 15초: 약 4.5분; 미니는 더 빠름(720p에서 5초: 약 1.5-2.5분; 15초: 약 3분) |
| **응답 필드** | `content.video_url` (mp4 직접 링크, **24시간 후 만료**), `usage.completion_tokens` |
| **작업 보관 기간** | task\_id는 7일 동안 조회 가능 |
## API 엔드포인트
| 엔드포인트 | 용도 | Content-Type |
| ------------------------------------------------------ | --------------------------- | ------------------ |
| `POST /seedance/api/v3/contents/generations/tasks` | 동영상 생성 작업을 생성합니다 | `application/json` |
| `GET /seedance/api/v3/contents/generations/tasks/{id}` | 작업 상태를 조회하거나 동영상 URL을 가져옵니다 | — |
**도메인**: `api.apiyi.com`는 주 게이트웨이입니다. `vip.apiyi.com` 및 기타 플랫폼 도메인은 동일하게 동작합니다. 경로 접두사는 `/seedance/api/v3`입니다 — **`/api` 세그먼트를 삭제하지 마십시오**, 그리고 `/v1/videos`을 사용하지 마십시오.
## 해상도 및 종횡비 자세히 보기
해상도 티어는 **짧은 변**이 아니라 **픽셀 면적**을 정의합니다. 종횡비별 실제 출력 해상도는 다음과 같습니다(공식 값이며, 저희 테스트에서 검증됨).
| 비율 | 480p | 720p | 1080p (표준 전용) |
| ---------- | -------------------------- | -------- | ------------- |
| `16:9` | 864×496 | 1280×720 | 1920×1080 |
| `4:3` | 752×560 | 1112×834 | 1664×1248 |
| `1:1` | 640×640 | 960×960 | 1440×1440 |
| `3:4` | 560×752 | 834×1112 | 1248×1664 |
| `9:16` | 496×864 | 720×1280 | 1080×1920 |
| `21:9` | 992×432 | 1470×630 | 2206×946 |
| `adaptive` | 모델이 입력에 따라 위 값 중 하나를 선택합니다 | 동일 | 동일 |
### 적응형 동작 방식
1. **텍스트-투-비디오**: 모델이 prompt에서 가장 적합한 비율을 추론합니다
2. **첫 프레임+마지막 프레임 / 첫 프레임**: 첫 프레임 이미지의 비율과 일치합니다(불일치하는 이미지는 중앙 기준으로 잘립니다)
3. **멀티모달 참조-투-비디오**: prompt 의도를 따르며, 그렇지 않으면 첫 번째 미디어 항목을 따릅니다(비디오는 이미지보다 우선합니다)
4. 실제로 사용된 비율은 작업 응답의 `ratio` 필드에 반환됩니다
`ratio`은 위의 7개 enum 값만 허용합니다. 예를 들어 `"2:1"`를 전달하면 `InvalidParameter` 오류가 반환되며(검증됨), `duration`가 4-15 범위를 벗어나도 마찬가지입니다. 어느 경우도 과금되지 않습니다.
## 모범 사례
1080p 또는 최대 품질이 필요하면 표준 모델 `doubao-seedance-2-0-260128`을 선택하고, 배치 제작과 비용 민감한 워크로드에는 경량 모델 `doubao-seedance-2-0-mini-260615`을 선택합니다(**표준 가격의 절반 정도이고 생성 속도가 가장 빠름**, 최대 720p로 제한됨). 중간 선택지로는 `fast`을 선택합니다.
이미지에서 동영상으로 변환할 때는 기본값 `adaptive`를 유지하여 모델이 원본 이미지의 비율에 맞추도록 합니다. 대상 플랫폼이 요구할 때만 `9:16`(세로) 또는 `16:9`(가로)를 고정합니다.
비용은 길이에 비례해서 증가합니다. 먼저 5초 클립으로 prompt를 검증한 다음 10-15초로 늘리고, 페이스 조절을 모델에 맡기는 편이 더 나을 때는 `duration: -1`를 사용합니다.
`generate_audio`는 기본값이 true입니다. 직접 음원을 입힐 계획인 무음 영상에는 `false`를 전달합니다.
프롬프트에서 대사를 큰따옴표 안에 넣으면 됩니다 — 모델이 일치하는 음성을 자동으로 생성합니다.
게이트웨이는 응답을 `content-encoding: gzip`로 표시하지만 본문은 압축되지 않은 상태입니다. Python requests 같은 자동 압축 해제 클라이언트는 `ContentDecodingError`를 발생시킵니다. `Accept-Encoding: identity` 헤더를 추가하면 이 문제를 피할 수 있습니다(curl은 영향을 받지 않습니다).
작업은 보통 2-5분 안에 완료됩니다. `content.video_url`는 24시간 동안 유효한 서명된 링크입니다 — 작업이 성공하자마자 파일을 자체 저장소로 복사합니다.
워터마크 없는 마지막 프레임 png를 얻으려면 `return_last_frame: true`를 설정한 다음, 다음 작업의 첫 프레임으로 사용해 연속적인 멀티 클립 동영상을 만듭니다.
## 오류 코드 및 재시도
| 코드 | 의미 | 권장 처리 |
| -------------- | -------------------------------------------------------------- | ------------------------------------------------ |
| `400` | `InvalidParameter`: 잘못된 해상도/종횡비/재생 시간(예: fast 또는 mini + 1080p) | 메시지에 문제가 된 매개변수가 표시되므로 위 표에 따라 수정하십시오. 과금되지 않습니다 |
| `401` | 잘못된 token | Bearer token을 확인하십시오 |
| `403` | 콘텐츠 모더레이션 거부(실제 얼굴, 정책 위반) | 에셋 또는 prompt를 변경하십시오 |
| `429` | 요청 제한됨 / 쿼터 부족 | 지수 백오프를 적용하고 잔액을 확인하십시오 |
| `5xx` | 게이트웨이 / 백엔드 오류 | 1-2회 다시 시도하십시오 |
| Task `failed` | 생성에 실패했습니다 | 작업의 error 필드를 확인하십시오. 필요하면 다른 seed로 다시 시도하십시오 |
| Task `expired` | `execution_expires_after`를 초과했습니다(기본 48시간) | 다시 제출하십시오 |
**클라이언트 권장 사항**:
* 30-60 s 요청 타임아웃이면 create/poll 호출에 충분합니다(대기는 작업 측에서 발생합니다)
* 15-30 s마다 폴링하고 전체 예산은 **15분 이상**으로 설정하십시오(1080p / 15 s 작업은 더 길게)
* 5xx와 타임아웃에는 **지수 백오프**를 적용하십시오(2회 재시도)
* 문제 해결을 위해 작업 `id`와 `x-request-id` 응답 헤더를 기록하십시오
## 자주 묻는 질문
가장 흔한 Seedance 2.0 오류입니다. 귀하의 Token에 `SeeDance2` 그룹이 활성화되어 있지 않습니다. Default 그룹이나 다른 비디오 그룹의 Token은 이 모델로 라우팅할 수 없습니다. Token 설정에서 `SeeDance2` 그룹을 활성화하고 Pay-as-you-go Priority 과금 모델을 사용하십시오.
게이트웨이의 `content-encoding: gzip` 헤더가 실제 본문 인코딩과 일치하지 않습니다. 증상에는 `ContentDecodingError`, 잘린 non-JSON 본문(예: 앞의 `{"`가 사라지고 `id":"cgt-xxx"}`만 받는 경우), 또는 간헐적인 400 오류가 포함됩니다. 요청 헤더에 `"Accept-Encoding": "identity"`를 추가하십시오. curl과 브라우저 fetch에는 영향이 없습니다.
`generate_audio`는 `true`으로 기본 설정됩니다(검증됨). 이 모델은 음성, 음향 효과, 배경 음악을 자동으로 추가합니다. 무음 출력을 원하면 `"generate_audio": false`를 명시적으로 전달하십시오.
성공 시 URL은 폴링 응답의 `content.video_url`에 있습니다(**최상위가 아님**). 약 24시간 동안 유효한 서명된 링크이므로 즉시 다운로드하여 다시 호스팅하십시오. task\_id 자체는 7일 동안 계속 조회할 수 있습니다.
상태 머신은 `queued → running → succeeded / failed / expired`입니다. 성공 상태는 \*\*`succeeded`\*\*이며, `completed`가 아닙니다. 다른 비디오 API에서 마이그레이션할 때 쉽게 하는 실수입니다.
아닙니다. Seedance 2.0은 실제 인간 얼굴이 포함된 참조 이미지/비디오를 거부합니다(상위 콘텐츠 안전성). 대안으로는 최근 30일 이내에 Seedance 모델로 생성된 얼굴 포함 출력을 재사용하거나, 플랫폼의 사전 설정 가상 아바타(`asset://` IDs)를 사용하거나, 라이선스가 부여된 얼굴 에셋을 사용하십시오.
매개변수 거부(HTTP 400)는 **과금되지 않습니다**(검증됨). 과금은 제출 시 선청구되고 완료 시 정산되므로 잔액이 잠시 변동됩니다. 호출 로그와 대조하여 확인하십시오.
`tokens ≈ duration(s) × width × height × 24 / 1024`, 0.1% 이내로 검증됨. 각 등급의 모든 비율은 같은 픽셀 면적을 가집니다(720p 16:9와 9:16은 모두 5초당 108,900 tokens 비용) — **가로형, 세로형, 정사각형 모두 비용이 같습니다**.
가격과 속도는 mini \< fast \< standard 순입니다(플랫폼 내 720p/5s 명목가: 약 ¥3.16 / ¥5.08 / ¥6.35). **대량 제작과 비용 민감한 작업에는 mini를 선택하십시오** — standard 가격의 약 절반이며 생성 속도가 가장 빠릅니다(2026-07 측정: 720p 기준 5초에 약 1.5-2.5분). 1080p나 최대 디테일이 필요하면 standard를 선택하고, 중간 선택지로는 fast를 사용하십시오. mini와 fast는 모두 720p로 제한되며, 1080p를 요청하면 400 매개변수 오류가 반환됩니다(과금되지 않음).
모델이 4초에서 15초 사이의 길이를 선택하며(우리 테스트에서는 10초 비디오가 생성되었습니다), 실제 출력 기준으로 과금됩니다. 최종 길이는 작업의 `duration` 필드에 반환됩니다. 비용 예측 가능성이 중요하다면 duration을 명시적으로 고정하십시오.
아닙니다. `frames`과 `camera_fixed`는 Seedance 1.x 매개변수이며 — **Seedance 2.0 시리즈에서는 지원되지 않습니다**. 대신 정수 초 `duration`를 사용하십시오.
아닙니다. 이들은 세 가지 **상호 배타적** 모드입니다: first+last(필수 `first_frame`/`last_frame` 역할이 있는 2개 이미지), first frame(1개 이미지), 그리고 multi-modal reference-to-video(0-9개 이미지 + 0-3개 비디오 + 0-3개 오디오, 최소 1개 이미지 또는 1개 비디오, 이미지 역할 `reference_image`)입니다. "첫/마지막 프레임 + reference"를 근사하려면 reference 모드를 사용하고 prompt를 통해 프레임을 지정하십시오.
SeeDance2 그룹은 충분한 동시 실행 수를 제공하며 대기열이 없습니다(테스트에서 15개의 동시 작업이 모두 즉시 실행되었습니다). 더 큰 지속 작업량은 영업팀에 문의하십시오.
prompt는 약 500개의 중국어 문자 또는 약 1000개의 영어 단어 이내로 유지하십시오. 더 긴 prompt는 세부 정보를 희석합니다. 지원 언어는 중국어, 영어, 일본어, 스페인어, 포르투갈어, 인도네시아어입니다. 주제 + 동작 + 카메라 움직임 + 조명/스타일을 설명하십시오.
## 관련 문서
* [동영상 생성 API 레퍼런스 & 플레이그라운드](/ko/api-capabilities/seedance2/video-generation) - `POST /seedance/api/v3/contents/generations/tasks`
* [Sora 2 동영상 생성](/ko/api-capabilities/sora-2/overview) - OpenAI 공식 릴레이 동영상 채널
* [VEO 3.1 동영상 생성](/ko/api-capabilities/veo-3-1-official/overview) - Google 공식 동영상 채널
* [충전 보너스](/ko/faq/recharge-promotions) - 실제 비용은 공식 채널과 거의 비슷합니다
* [API 매뉴얼](/ko/api-manual) - 일반 호출 규칙
Seedance 2.0은 기본적으로 동기화된 오디오를 **출력하는** 몇 안 되는 2026년 최상위 동영상 모델 중 하나입니다. 동일 가격의 화면 비율과 15초 상한이 결합되어 짧은 동영상과 이커머스 자산 제작을 위한 강력한 주력 채널입니다. 대안을 비교하려면, 추가 그룹이 활성화된 동일한 Token으로 Sora 2, VEO 3.1, 그리고 Wan2.7을 직접 호출할 수 있습니다.