Seedance 2.0 동영상 생성 - API易文档中心

개요

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(중국어, 영어, 일본어, 스페인어, 포르투갈어, 인도네시아어). 숏폼 영상 제작, 이커머스 소재, 모션 디자인, 가상 휴먼 콘텐츠를 대규모로 제작하도록 설계되었습니다.

동영상 생성 API 레퍼런스

POST /seedance/api/v3/contents/generations/tasks — 대화형 Playground와 전체 폴링/다운로드 코드가 포함된 비동기 작업 엔드포인트입니다.

API 매뉴얼

token 생성, 기본 URL, 과금 방식, 일반 호출 규칙입니다.

시각적 API 테스트

iCover 시각적 테스트 도구에서 이 엔드포인트를 직접 디버그하세요 — 코드가 필요 없습니다.

비동기 작업 조회 / 다운로드

제출한 동영상 작업을 보고 APIYI 콘솔에서 동영상 링크를 다운로드할 수 있습니다 — API 밖의 조회 항목입니다.

왜 APIYI의 Seedance 2.0인가요?

먼저 포지셔닝에 대한 메모입니다. 이 모델에는 공식 할인은 없고, APIYI도 이 모델을 수익 목적으로 가격 책정하지 않습니다 — 공급을 안정적으로 확보하고 고객을 서비스하기 위해 제공합니다. APIYI를 통해 이용할 때의 진짜 가치는 “더 저렴함”이 아니라 접근성과 경험입니다:

공식 리소스 · 중국 본토 버전

공식 Volcengine 중국 본토 리소스(BytePlus 해외판이 아님)이며, upstream 콘텐츠 안전성이 내장되어 있습니다. 파라미터, 응답, 과금은 공식 API와 정확히 일치합니다.

무제한 동시 실행 수 · 대기열 없음

테스트에서 동시에 15개의 작업이 모두 running에 즉시 진입했으며 대기열은 전혀 없었습니다(2026-06-06 (UTC+8) 측정) — 대규모 배치 생산에 바로 사용할 수 있습니다.

공급 우선 가격 · 공식과 동일 수준

공식 할인은 없고 APIYI는 이 모델에서 수익을 남기지 않습니다. 단가 는 Volcengine의 공식 요금표와 맞춰져 있으며(플랫폼 내 과금은 대략 10% 더 높음), 충전 보너스를 함께 적용하면 실효 비용은 공식 채널과 거의 같은 수준이며, 고액 충전 고객은 일부 구간에서 그보다 더 낮아질 수 있습니다.

마찰 없는 접근 · 신원 인증 불필요

Volcengine 계정 없음, 실명/신원 인증 없음, 지출 기준 없음(CNY 200 활성화 보증금과 기업 인증 생략). 중국 본토 데이터 센터, 가정용 네트워크, 해외 노드 모두 단일 token으로 api.apiyi.com에 직접 접속할 수 있습니다.

가상 얼굴 화이트리스트 접근

이 채널에는 upstream의 가상 얼굴 화이트리스트 접근 권한이 포함되어 있습니다. AI가 생성한 얼굴과 가상 아바타를 image-to-video에 바로 사용할 수 있으며, 공식 채널에 별도로 화이트리스트를 신청할 필요가 없습니다(실제 사람 얼굴은 upstream 콘텐츠 안전성에 의해 계속 제한됩니다).

전체 동영상 모델 라인업

VEO 3.1, Sora 2, Wan2.7을 같은 플랫폼에서 이용할 수 있습니다. 사용 사례에 따라 자유롭게 조합해 사용하십시오.

전문 지원

동영상 생성 워크로드 경험이 있는 팀이 PoC부터 운영 단계까지 모델 선택, 튜닝, 통합을 지원합니다.

주요 기능

3단계 · 단계별 동일 가격

480p / 720p / 1080p (1080p 표준 모델만 해당). 한 단계 내에서는 16:9, 9:16, 1:1 및 그 외 모든 비율이 동일한 픽셀 면적과 동일한 가격을 공유합니다. 가로와 세로를 전환해도 추가 비용이 들지 않습니다.

기본 동기화 오디오

generate_audio의 기본값은 true입니다. 음성, 음향 효과, 배경 음악이 시각 요소에 맞게 생성됩니다. 음성 해설 품질을 높이려면 대사를 큰따옴표로 감싸십시오.

4-15초 조절 가능 길이

duration은 4초에서 15초 사이의 정수 초를 받거나 -1으로 모델이 길이를 정하도록 할 수 있습니다(실제 출력 기준 과금). 24 fps 고정입니다.

다국어 prompt

중국어(최대 약 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배이며, 충전 보너스(일반 고객 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% 충전 보너스 이후의 유효 가격입니다. 보너스 적용 후 가격은 공식 기준에 가깝게 형성되며, 1080p 대형 고객 가격은 공식보다 더 낮습니다. 권위 있는 사용량은 반환된 usage.completion_tokens입니다.

과금 참고 사항:

최종 청구는 콘솔의 모델 과금과 호출 로그를 따릅니다
작업은 제출 시 선청구되고 완료 시 정산됩니다 — 잔액이 잠시 변동하며, 호출 로그와 대조해야 합니다. 동영상 하나당 두 개의 청구 항목이 생성됩니다(아래 “로그에서 청구 내역 읽기” 참조)
거부된 요청(HTTP 400 매개변수 오류 등)은 과금되지 않습니다(검증됨)
비용은 지속 시간에 비례합니다. 15초 동영상은 5초 동영상의 약 3배입니다

로그에서 과금 읽기 (사전 과금 + 정산)

api.apiyi.com/log의 콘솔 로그 페이지를 열고 모델 이름 doubao-seedance-2-0을 검색하면 모든 과금 내역을 볼 수 있습니다. 비디오 하나는 과금 항목을 2개 생성합니다:

사전 과금: 작업이 제출될 때 차감되는 추정 금액입니다(“비스트리밍”으로 표시된 로그 항목이며, token과 그룹을 보여줍니다) — 아래 스크린샷에서는 $0.449998입니다
정산(과금 또는 환불): 작업이 완료된 뒤 실제 생성된 tokens를 기준으로 차액을 정산합니다(“streaming”으로 표시된 로그 항목이며, completion-token 수가 있습니다) — 아래에서는 $5.611858입니다; 1080p는 보통 추가 과금이 발생합니다

APIYI 로그 페이지에서 하나의 Seedance 2.0 비디오에 대한 두 과금 항목을 보여줍니다: 사전 과금과 정산 — Two charge entries for one 15 s 1080p video: pre-charge + settlement

정산 항목에는 token도 그 그룹도 표시되지 않습니다 — 이는 정상입니다. 두 항목의 합이 비디오의 총 비용입니다.

시간 필드를 읽는 방법:

첫 번째 항목(사전 과금)의 타임스탬프는 비디오의 제출 시간입니다. 그 “first byte” 값은 제출이 task ID를 반환하는 데 걸린 시간입니다(예: 首字节:3秒 / first byte: 3 s) — 생성 시간이 아닙니다
정산 항목에는 流式(streaming)와 首字节:<1秒(1초 미만의 first byte)가 표시됩니다 — 이는 정산 기록의 내부 표식일 뿐이며, 문제가 있다는 신호가 아닙니다
비디오의 실제 생성 시간은 상단 내비게이션의 “Async tasks” 페이지(api.apiyi.com/task)에 있는 “耗时” (elapsed) 열입니다

로그 페이지에서 시간과 first-byte 필드를 읽는 방법: 첫 번째 항목은 제출 시간과 제출 지연 시간입니다 — The first log entry's timestamp = submission time, and its first-byte value (3 s) is the submission latency; this fast example settled as a refund (negative amount), total cost 0.360000 − 0.022750 = 0.337250 USD

각 비디오 작업의 제출 시간과 생성 경과 시간을 보여주는 Async tasks 페이지 — The elapsed column on the Async tasks page is the actual video generation time, e.g. 158 s, 303 s

첫 번째 스크린샷의 15 s 1080p 비디오는 총 비용이 0.449998 + 5.611858 = $6.061856입니다. 일치하는 작업 매개변수는 api.apiyi.com/task 상단의 “Async tasks” 아래에서 확인할 수 있으며, 과금과 정확히 일치합니다:

{
  "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 비율의 명목상 과금 기준). 충전 보너스를 적용하면 실질 비용은 대략 ¥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배입니다. 충전 보너스를 더하면 일반 사용자는 공식 가격보다 약 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`	모델이 입력에 따라 위 값 중 하나를 선택합니다	동일	동일

적응형 동작 방식

텍스트-투-비디오: 모델이 prompt에서 가장 적합한 비율을 추론합니다
첫 프레임+마지막 프레임 / 첫 프레임: 첫 프레임 이미지의 비율과 일치합니다(불일치하는 이미지는 중앙 기준으로 잘립니다)
멀티모달 참조-투-비디오: prompt 의도를 따르며, 그렇지 않으면 첫 번째 미디어 항목을 따릅니다(비디오는 이미지보다 우선합니다)
실제로 사용된 비율은 작업 응답의 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를 사용합니다

이미지에서 동영상으로 변환할 때는 기본값 adaptive를 유지하여 모델이 원본 이미지의 비율에 맞추도록 합니다. 대상 플랫폼이 요구할 때만 9:16(세로) 또는 16:9(가로)를 고정합니다.

지속 시간은 비용 조절 다이얼입니다

비용은 길이에 비례해서 증가합니다. 먼저 5초 클립으로 prompt를 검증한 다음 10-15초로 늘리고, 페이스 조절을 모델에 맡기는 편이 더 나을 때는 duration: -1를 사용합니다.

필요하지 않으면 오디오를 끕니다

generate_audio는 기본값이 true입니다. 직접 음원을 입힐 계획인 무음 영상에는 false를 전달합니다.

더 나은 보이스오버를 위해 대사를 따옴표로 감쌉니다

프롬프트에서 대사를 큰따옴표 안에 넣으면 됩니다 — 모델이 일치하는 음성을 자동으로 생성합니다.

HTTP 클라이언트에서 Accept-Encoding: identity를 추가합니다

게이트웨이는 응답을 content-encoding: gzip로 표시하지만 본문은 압축되지 않은 상태입니다. Python requests 같은 자동 압축 해제 클라이언트는 ContentDecodingError를 발생시킵니다. Accept-Encoding: identity 헤더를 추가하면 이 문제를 피할 수 있습니다(curl은 영향을 받지 않습니다).

15-30초마다 폴링하고 즉시 다운로드합니다

작업은 보통 2-5분 안에 완료됩니다. content.video_url는 24시간 동안 유효한 서명된 링크입니다 — 작업이 성공하자마자 파일을 자체 저장소로 복사합니다.

return_last_frame으로 클립을 연결합니다

워터마크 없는 마지막 프레임 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 응답 헤더를 기록하십시오

자주 묻는 질문

이 모델에서 'no available channel for this model'이 표시되는 이유는 무엇입니까?

가장 흔한 Seedance 2.0 오류입니다. 귀하의 Token에 SeeDance2 그룹이 활성화되어 있지 않습니다. Default 그룹이나 다른 비디오 그룹의 Token은 이 모델로 라우팅할 수 없습니다. Token 설정에서 SeeDance2 그룹을 활성화하고 Pay-as-you-go Priority 과금 모델을 사용하십시오.

Python requests에서 gzip 오류가 발생하거나 잘린 non-JSON 본문이 반환되는 이유는 무엇입니까?

게이트웨이의 content-encoding: gzip 헤더가 실제 본문 인코딩과 일치하지 않습니다. 증상에는 ContentDecodingError, 잘린 non-JSON 본문(예: 앞의 {"가 사라지고 id":"cgt-xxx"}만 받는 경우), 또는 간헐적인 400 오류가 포함됩니다. 요청 헤더에 "Accept-Encoding": "identity"를 추가하십시오. curl과 브라우저 fetch에는 영향이 없습니다.

내 비디오에 왜 소리가 있습니까? 어떻게 끌 수 있습니까?

generate_audio는 true으로 기본 설정됩니다(검증됨). 이 모델은 음성, 음향 효과, 배경 음악을 자동으로 추가합니다. 무음 출력을 원하면 "generate_audio": false를 명시적으로 전달하십시오.

비디오 URL은 어디에 있으며, 왜 더 이상 동작하지 않습니까?

성공 시 URL은 폴링 응답의 content.video_url에 있습니다(최상위가 아님). 약 24시간 동안 유효한 서명된 링크이므로 즉시 다운로드하여 다시 호스팅하십시오. task_id 자체는 7일 동안 계속 조회할 수 있습니다.

성공 상태 값은 무엇입니까?

상태 머신은 queued → running → succeeded / failed / expired입니다. 성공 상태는 **succeeded**이며, completed가 아닙니다. 다른 비디오 API에서 마이그레이션할 때 쉽게 하는 실수입니다.

image-to-video에 실제 사람 사진을 업로드할 수 있습니까?

아닙니다. Seedance 2.0은 실제 인간 얼굴이 포함된 참조 이미지/비디오를 거부합니다(상위 콘텐츠 안전성). 대안으로는 최근 30일 이내에 Seedance 모델로 생성된 얼굴 포함 출력을 재사용하거나, 플랫폼의 사전 설정 가상 아바타(asset:// IDs)를 사용하거나, 라이선스가 부여된 얼굴 에셋을 사용하십시오.

실패하거나 거부된 요청도 과금됩니까?

매개변수 거부(HTTP 400)는 과금되지 않습니다(검증됨). 과금은 제출 시 선청구되고 완료 시 정산되므로 잔액이 잠시 변동됩니다. 호출 로그와 대조하여 확인하십시오.

token 사용량은 어떻게 추정합니까? 세로형이 더 비쌉니까?

tokens ≈ duration(s) × width × height × 24 / 1024, 0.1% 이내로 검증됨. 각 등급의 모든 비율은 같은 픽셀 면적을 가집니다(720p 16:9와 9:16은 모두 5초당 108,900 tokens 비용) — 가로형, 세로형, 정사각형 모두 비용이 같습니다.

Standard, fast, mini 중 어느 것을 선택해야 합니까?

가격과 속도는 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 매개변수 오류가 반환됩니다(과금되지 않음).

duration: -1은 무엇을 합니까?

모델이 4초에서 15초 사이의 길이를 선택하며(우리 테스트에서는 10초 비디오가 생성되었습니다), 실제 출력 기준으로 과금됩니다. 최종 길이는 작업의 duration 필드에 반환됩니다. 비용 예측 가능성이 중요하다면 duration을 명시적으로 고정하십시오.

frames 매개변수는 소수 초를 지원합니까?

아닙니다. frames과 camera_fixed는 Seedance 1.x 매개변수이며 — Seedance 2.0 시리즈에서는 지원되지 않습니다. 대신 정수 초 duration를 사용하십시오.

first+last frame, first frame, reference 이미지를 섞을 수 있습니까?

아닙니다. 이들은 세 가지 상호 배타적 모드입니다: 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 제한이 있습니까?

prompt는 약 500개의 중국어 문자 또는 약 1000개의 영어 단어 이내로 유지하십시오. 더 긴 prompt는 세부 정보를 희석합니다. 지원 언어는 중국어, 영어, 일본어, 스페인어, 포르투갈어, 인도네시아어입니다. 주제 + 동작 + 카메라 움직임 + 조명/스타일을 설명하십시오.

​개요

동영상 생성 API 레퍼런스

API 매뉴얼

시각적 API 테스트

비동기 작업 조회 / 다운로드

​왜 APIYI의 Seedance 2.0인가요?

공식 리소스 · 중국 본토 버전

무제한 동시 실행 수 · 대기열 없음

공급 우선 가격 · 공식과 동일 수준

마찰 없는 접근 · 신원 인증 불필요

가상 얼굴 화이트리스트 접근

전체 동영상 모델 라인업

전문 지원

​주요 기능

3단계 · 단계별 동일 가격

기본 동기화 오디오

4-15초 조절 가능 길이

다국어 prompt

첫+마지막 / 첫 프레임

멀티모달 참조-비디오

비동기 작업 흐름

재현 가능한 시드

​요금

​공식 가격 기준 (16:9 / 5초 출력, 동영상당 CNY)

​로그에서 과금 읽기 (사전 과금 + 정산)

​그룹 설정

​기술 사양

​API 엔드포인트

​해상도 및 종횡비 자세히 보기

​적응형 동작 방식

​모범 사례

​오류 코드 및 재시도

​자주 묻는 질문

​관련 문서

개요

왜 APIYI의 Seedance 2.0인가요?

주요 기능

요금

공식 가격 기준 (16:9 / 5초 출력, 동영상당 CNY)

로그에서 과금 읽기 (사전 과금 + 정산)

그룹 설정

기술 사양

API 엔드포인트

해상도 및 종횡비 자세히 보기

적응형 동작 방식

모범 사례

오류 코드 및 재시도

자주 묻는 질문

관련 문서