Seedance 2.0 / 2.5 동영상 생성

개요

doubao-seedance-2-5-260628 (2.5), doubao-seedance-2-0-260128 (표준), doubao-seedance-2-0-fast-260128 (고속), doubao-seedance-2-0-mini-260615 (미니/라이트)는 ByteDance의 최신 동영상 생성 모델 제품군입니다. 네 가지 모델이 병렬로 운영되며, APIYI를 통해 공식 Volcengine 중국 본토 리소스(BytePlus 국제 버전 아님)에서 제공되고 업스트림 콘텐츠 안전 기능이 내장되어 있습니다. 텍스트-동영상, 첫 프레임+마지막 프레임/첫 프레임 이미지-동영상, 멀티모달 참조-동영상을 지원하며, 영상과 동기화된 음성, 음향 효과 및 배경 음악을 생성할 수 있습니다. 2.5는 가장 강력한 티어입니다: 길이 제한이 15초에서 30초로 늘어나고, 참조 이미지는 9개에서 30개로 증가하며, 오디오는 단독 참조로 사용할 수 있고, mov 출력과 명시적인 동영상 편집/연장 작업 유형도 추가됩니다. 비용도 더 높습니다 — 2.0 표준 모델의 약 1.5배(720p/5초 기준 약 $1.35, $0.91)이며, 이는 Volcengine 자체 정가에서 두 세대 간 차이와 일치합니다. 2.0 제품군은 계속 제공되며 종료되지 않습니다. 15초 미만의 일반 클립에서는 표준 모델이 더 저렴하고 1080p도 지원합니다. 미니는 대량 제작에 적합한 선택지로, 표준 모델 단가의 약 절반이며 생성 속도가 더 빠르고, 720p로 제한됩니다. 고속 모델은 그 중간에 위치합니다. 2.5는 2.0 제품군과 동일한 SeeDance2 그룹(0.18x)에서 실행됩니다 — 하나의 token으로 네 모델 모두에 접근할 수 있습니다. 아래의 “그룹 설정”을 참조하십시오.

🎬 주요 특징: 2.5는 4-30초, 2.0 제품군은 4-15초를 지원합니다(둘 다 모델이 길이를 선택하는 -1를 허용함). 세 가지 해상도 티어(480p/720p/1080p, 1080p는 2.5 및 2.0 표준 모델로 제한), 6가지 화면비와 적응형 화면비, 기본 활성화된 동기화 오디오, 다국어 prompt를 제공합니다. 대규모 숏폼 동영상 제작, 전자상거래 에셋, 모션 디자인 및 가상 인간 콘텐츠를 위해 설계되었습니다.

🔥 기간 한정 할인 — 2026-10-07 23:59 (UTC+8)까지: 두 개의 새 단일 모델 그룹인 SD2Mini (0.10x) 및 SD2Fast (0.15x)는 mini의 요율을 44.4%, fast의 요율을 16.7% 인하합니다. 새 Token 하나로 교체하기만 하면 되며 코드 변경은 필요 없습니다. 아래의 “기간 한정 할인 그룹” 및 “그룹 설정”을 참조하십시오.

2.5를 호출하는 Token에는 SeeDance2 그룹(요율 0.18x)이 필요합니다 — 2.0 제품군과 동일한 그룹입니다. Default 그룹 또는 다른 동영상 그룹의 token으로 doubao-seedance-2-5-260628를 호출하면 “이 모델에 사용할 수 있는 채널이 없습니다” 오류가 발생합니다.SeeDance2가 활성화된 하나의 Token으로 네 모델 모두에 접근할 수 있습니다 — 2.5와 2.0 제품군은 동일한 그룹 및 동일한 요율을 공유하므로, 코드에서는 model 필드만 변경하면 됩니다.

동영상 생성 API 레퍼런스

대화형 Playground와 전체 폴링/다운로드 코드를 제공하는 비동기 작업 엔드포인트인 POST /seedance/api/v3/contents/generations/tasks입니다.

API 매뉴얼

Token 생성, 기본 URL, 과금 모델 및 일반 호출 규칙을 안내합니다.

시각적 API 테스트

코드 없이 iCover 시각적 테스트 도구에서 이 엔드포인트를 직접 디버깅합니다.

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

API 외부의 조회 항목으로 APIYI 콘솔에서 제출된 동영상 작업을 확인하고 동영상 링크를 다운로드합니다.

AI 에이전트에게 통합을 맡기기

Codex / Claude Code / Cursor로 구축하는 경우 아래 prompt를 복사하여 에이전트에 전달합니다. 먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 docs URL 뒤에 .md 추가), 프로젝트에서 사용하는 자체 스택으로 코드를 작성합니다. 비동기 폴링, 즉시 복사를 강제하는 24시간 링크 만료, gzip 헤더 함정 및 파라미터의 금지 조건이 이미 요구 사항에 포함되어 있습니다.

코딩 에이전트가 Seedance 2.5 / 2.0 동영상 생성을 통합하거나 문제를 해결하도록 합니다. Codex, Claude Code, Cursor 및 유사한 도구에 복사하여 붙여넣습니다.

이 prompt가 방지하는 문제

요구 사항	방지되는 함정
성공 상태는 `succeeded`	다른 동영상 모델에서 포팅할 때 자연스럽게 `completed`을 작성한 후 성공을 전혀 확인하지 못한 채 무한히 폴링하게 됨
작업 ID는 최상위 `id`	`task_id`이라고 부르지 않으며, 동영상 주소는 최상위가 아니라 `content.video_url`에 중첩되어 있음
`Accept-Encoding: identity` 전송	게이트웨이의 gzip 헤더가 본문과 모순되어 Python requests가 무작위 디코딩 오류를 발생시키거나 JSON을 잘라 냄
즉시 다운로드하고 다시 호스팅	링크는 24시간 후 만료되며, 다운로드 중 `Authorization`을 전송하면 오히려 작동하지 않음
과금 행 두 개는 정상	이중 과금이 아니라 보류와 정산이며, 실제 비용은 두 행의 합계임
실제 얼굴은 자산 라이브러리를 통해 처리	실제 인물의 사진을 직접 전송하면 검토에서 거부되므로, 먼저 등록한 후 `asset://`로 참조해야 함
2.5에서 `duration`의 기본값은 `-1`	기간을 생략하면 모델이 자체적으로 길이를 선택하며(테스트에서는 10초), 비용이 두 배가 됨
2.5에서는 세 가지 작업 유형에 `ratio: adaptive`이 강제됨	첫 프레임/마지막 프레임, 편집 및 확장에서는 구체적인 종횡비를 지정하면 400으로 거부됨

APIYI의 Seedance는 왜 사용합니까?

먼저 포지셔닝에 대해 설명합니다. 이 모델에는 공식 할인 혜택이 없으며, APIYI는 수익을 목적으로 가격을 책정하지 않습니다. 이 모델은 공급을 확보하고 고객에게 서비스를 제공하기 위해 제공됩니다. APIYI를 이용하는 진정한 가치는 “더 저렴한 가격”이 아니라 액세스와 사용 경험에 있습니다.

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

BytePlus 국제 버전이 아닌 Volcengine 중국 본토 공식 리소스를 사용하며, 업스트림 콘텐츠 안전 기능이 기본 제공됩니다. 매개변수, 응답 및 과금이 공식 API와 정확히 일치합니다.

가상 얼굴 화이트리스트 액세스

이 채널에는 업스트림 가상 얼굴 화이트리스트 액세스가 포함됩니다. AI로 생성된 얼굴과 가상 아바타를 이미지-동영상 변환에 직접 사용할 수 있으며, 공식 채널에 별도로 화이트리스트를 신청할 필요가 없습니다. 단, 실제 사람의 얼굴은 업스트림 콘텐츠 안전 정책에 따라 계속 제한됩니다.

에셋 라이브러리 무료 포함

캐릭터 일관성 동영상(가상 아바타 등록 + 실제 인물 검증)을 지원하는 비공개 에셋 라이브러리를 APIYI에서는 무료로 제공합니다. 공식적으로는 별도 구매하는 애드온이며, 프레임워크 계약이 없는 고객에게는 연간 수십만 위안 규모의 계약이 필요합니다. API 가격에 이 기능을 포함합니다.

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

공식 할인은 없으며 APIYI는 이 모델에서 수익을 얻지 않습니다. 단가는 Volcengine의 공식 가격표와 일치합니다. 플랫폼 내 과금은 대략 10% 더 높지만, 충전 보너스를 함께 적용하면 실질 비용은 공식 채널과 거의 동일한 수준이며, 일부 등급에서는 고액 충전 고객이 공식 채널보다 낮은 가격으로 이용할 수 있습니다.

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

테스트 결과 15개의 동시 작업이 모두 즉시 running에 진입했으며 대기열은 전혀 발생하지 않았습니다(2026-06-06 (UTC+8) 측정). 대규모 일괄 제작에 바로 사용할 수 있습니다.

마찰 없는 액세스 · 신원 인증 없음

Volcengine 계정, 실명/신원 인증, 최소 지출 금액이 필요하지 않습니다(CNY 200 활성화 보증금 및 기업 인증을 건너뛸 수 있습니다). 중국 본토 데이터센터, 주거용 네트워크 및 해외 노드에서 모두 단일 Token으로 api.apiyi.com에 직접 액세스할 수 있습니다.

전체 동영상 모델 라인업

VEO 3.1과 Wan2.7을 동일한 플랫폼에서 사용할 수 있으므로 사용 사례에 따라 자유롭게 조합할 수 있습니다.

전문 지원

동영상 생성 워크로드에 대한 경험이 풍부한 팀이 PoC부터 프로덕션까지 모델 선택, 튜닝 및 통합을 지원합니다.

주요 기능

3가지 티어 · 티어별 동일 가격

480p / 720p / 1080p(1080p는 2.5 및 2.0 standard에서만 지원; fast 및 mini는 최대 720p). 각 티어 내에서 16:9, 9:16, 1:1 및 기타 모든 비율은 동일한 픽셀 영역과 동일한 가격을 공유합니다. 가로와 세로 간 전환은 추가 비용이 없습니다.

기본 동기화 오디오

generate_audio의 기본값은 true입니다. 음성, 효과음, 배경 음악이 영상에 맞춰 생성됩니다. 보이스오버 품질을 높이려면 대사를 큰따옴표로 묶으십시오.

최대 30초의 제어 가능한 길이

2.5는 4~30의 정수 초를 지원하며, 2.0 제품군은 4~15초를 지원합니다. -1를 사용하면 모델이 길이를 선택합니다(실제 출력 기준 과금). 2.5에서 duration의 기본값은 -1입니다. 생략하면 모델이 자동으로 선택합니다. 고정 24 fps입니다.

다국어 prompt

중국어(최대 약 500자)와 영어(최대 약 1000단어), 그리고 일본어, 스페인어, 포르투갈어, 인도네시아어를 지원합니다.

첫+마지막 / 첫 프레임

두 이미지를 사용해 첫 프레임과 마지막 프레임을 모두 고정하거나, 단일 이미지를 첫 프레임으로 애니메이션화할 수 있습니다. return_last_frame와 결합하여 클립을 연결하면 더 긴 연속 동영상을 만들 수 있습니다.

멀티모달 참조-동영상

2.5는 최대 이미지 30개 + 동영상 10개 + 오디오 10개를 지원하며, 오디오는 단독으로 사용할 수 있습니다. 2.0 제품군은 이미지 9개 + 동영상 3개 + 오디오 3개를 지원하며, 오디오 사용 시 이미지 또는 동영상을 함께 제공해야 합니다. 캐릭터와 스타일의 일관성을 유지하면서 동영상을 생성, 편집 또는 확장할 수 있습니다.

비동기 작업 흐름

제출 후 task_id를 받고, 상태를 폴링한 다음 content.video_url에서 mp4를 다운로드합니다(링크는 24시간 동안 유효).

재현 가능한 시드

seed를 고정하면 실행 간 유사한 결과를 얻을 수 있습니다. watermark의 기본값은 false이므로 출력물에 워터마크가 없습니다.

가격

한 줄 요약 — 정밀한 token 과금으로, 등급별 가격은 Volcengine 공식 사이트에 맞춰 책정됩니다. 네 모델은 가격이 서로 다릅니다: mini < fast < standard < 2.5 (공식 사이트와 같은 방향이며, mini는 standard 모델 단가의 약 절반이고 2.5는 약 1.5배입니다 — 동일한 가격대가 아닙니다). Volcengine은 이 시리즈에 할인을 제공하지 않으며, 이 채널은 공급 확보를 위해 가격이 책정되므로 명목 요율은 공식 요율보다 약간 높습니다. 하지만 충전 보너스 (일반 고객 10%, 대규모 예치 고객 최대 20%)를 적용하면 실질 비용은 공식 사이트와 사실상 동일한 수준입니다 — 대규모 예치 고객은 약 5%만 더 지불하며, 일부 등급(예: 1080p 대규모 고객 가격)에서는 오히려 더 저렴합니다. 과금은 면적×기간 기준이므로 ±5%의 편차는 정상 범위입니다 — 언제든지 테스트하고 대조해 보신 후 문의해 주시기 바랍니다.한 가지 더 안내드립니다. 캐릭터 일관성을 유지하는 동영상에 필요한 에셋 라이브러리는 APIYI에서 무료로 포함됩니다 (공식적으로는 별도 구매 애드온이며, 프레임워크 계약이 없는 고객의 경우 연간 6자리 CNY 규모의 계약이 필요합니다). 이 가치는 위의 단가 비교에 반영되지 않았습니다.

token 기반 과금: tokens ≈ (input video duration + output duration)(s) × output width × output height × 24 / 1024 (텍스트-/이미지-동영상 변환에서는 입력 동영상 길이가 0이며, 내부 테스트에서 0.1% 이내로 검증되었습니다). 한 등급 내 모든 비율은 동일한 픽셀 면적을 가지므로 가격은 해상도 등급, 출력 기간, 입력에 동영상이 포함되는지 여부에 따라서만 결정됩니다.

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

① 입력 동영상 없음 (텍스트-동영상 생성 / 이미지-동영상 생성 / 참조 이미지):

해상도	표준 `doubao-seedance-2.0`	빠름	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초 입력):

해상도	표준 `doubao-seedance-2.0`	빠름	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	5초	$0.7253	¥5.08	¥4.62	¥4.23	¥4.00
`doubao-seedance-2-0-fast-260128`	480p	5초	$0.3373	¥2.36	¥2.15	¥1.97	¥1.86
`doubao-seedance-2-0-260128`	720p	5초	$0.9074	¥6.35	¥5.77	¥5.29	¥4.97
`doubao-seedance-2-0-260128`	480p	5초	$0.4193	¥2.94	¥2.67	¥2.45	¥2.31
`doubao-seedance-2-0-260128`	1080p	5초	$2.0288	¥14.20	¥12.91	¥11.84	¥12.39
`doubao-seedance-2-0-fast-260128`	720p	4초	$0.5814	¥4.07	¥3.70	¥3.39	¥3.20
`doubao-seedance-2-0-fast-260128`	720p	8초	$1.1568	¥8.10	¥7.36	¥6.75	¥6.40
`doubao-seedance-2-0-mini-260615`	720p	5초	$0.4508	¥3.16	¥2.87	¥2.63	¥2.50
`doubao-seedance-2-0-mini-260615`	480p	4초	$0.1681	¥1.18	¥1.07	¥0.98	¥0.93
`doubao-seedance-2-0-mini-260615`	720p	15초	$1.3451	¥9.42	¥8.56	¥7.85	¥7.47

세 모델의 가격은 같지 않습니다 — 절대로 동일한 가격으로 취급해서는 안 됩니다. 동일한 해상도/길이에서 token당 가격은 Mini < 빠름 < 표준입니다(예: 720p/5초: Mini ≈ ¥3.16, 빠름 ≈ ¥5.08, 표준 ≈ ¥6.35). 이는 공식 가격 단계와 일치합니다. 배치 제작에서는 Mini가 비용과 시간을 가장 많이 절약합니다(2026-07 테스트에서 유효 단가가 플랫폼 명목 요율과 정확히 일치하는 0.00% 편차로 측정됨). 1080p는 표준만 지원됩니다.

참고: “CNY”는 플랫폼의 정가 과금액입니다. “일반 고객 ÷1.1”과 “대형 고객 ÷1.2”는 10% / 20% 충전 보너스 적용 후의 유효 가격입니다. 보너스 적용 후 가격은 공식 참고 가격에 근접하며, 1080p 대형 고객 가격은 공식 가격보다도 낮습니다. 권위 있는 사용량은 반환된 usage.completion_tokens입니다.

Seedance 2.5 가격(`SeeDance2` 그룹, 0.18x)

2.5와 2.0 제품군은 동일한 SeeDance2 그룹과 동일한 0.18x 요율을 공유합니다. 세대 간 가격 차이는 전적으로 모델 자체의 단가에서 발생합니다. 720p/5초는 2.5에서 $1.3721, 2.0 표준 모델에서 $0.9074로, 대략 1.5배입니다. 이 차이는 Volcengine 자체의 정가를 반영한 것입니다(Volcengine의 2.5 token 요율은 2.0보다 약 52% 높음). APIYI의 마진이 아닙니다. 업그레이드할 가치가 있는지는 실제로 30초 클립, 참조 이미지 30장, mov 출력 또는 동영상 편집/확장이 필요한지에 달려 있습니다. 필요하지 않다면 2.0 표준 모델이 더 저렴하고 1080p도 지원합니다. ① 입력에 동영상이 없는 경우(텍스트-동영상, 이미지-동영상, 참조 이미지):

해상도	길이	tokens	APIYI 비용	CNY	일반 ÷1.1 (CNY)	대형 고객 ÷1.2 (CNY)
480p	4초	38,830	$0.4893	¥3.42	¥3.11	¥2.85
480p	5초	48,437	$0.6103	¥4.27	¥3.88	¥3.56
720p	5초	108,900	$1.3721	¥9.60	¥8.73	¥8.00
720p	10초	216,900	$2.7329	¥19.13	¥17.39	¥15.94
720p	30초	648,900	$8.1761	¥57.23	¥52.03	¥47.69
1080p	5초	245,025	$3.0873	¥21.61	¥19.65	¥18.01

② 입력에 동영상이 있는 경우(video_url을 포함한 멀티모달 참조, 동영상 편집, 동영상 확장): 별도의 더 낮은 token 요율이 적용됩니다.

해상도	출력 길이	입력 동영상	tokens	APIYI 비용	CNY
480p	4초	약 5초	86,867	$0.6567	¥4.60

더 낮은 요율이 청구 금액이 더 낮다는 의미는 아닙니다. 입력에 동영상이 있으면 청구 대상 tokens = (입력 동영상 길이 + 출력 길이) × 면적이므로, token 수 자체가 증가합니다. 위 행은 요율 ①을 적용하면 $1.0945가 청구되지만, 요율 ②에서는 $0.6567입니다. 두 token 요율:

등급	백만 tokens당 $
① 입력에 동영상이 없는 경우(480p / 720p / 1080p 동일)	$12.60
② 입력에 동영상이 있는 경우	$7.56

두 token 수와 두 요율은 요율 계산이 아니라 실제 과금 로그에서 확인한 값입니다(2026-08-31 재검증). 충전 보너스를 적용하면 고등급 충전 고객의 가격은 공식 기준 가격에 가까워집니다.

2.5에서 과다 지출하기 가장 쉬운 두 가지 경우:

duration의 기본값이 -1입니다(2.0 제품군의 기본값은 5입니다). 이 값을 생략하면 2.5가 4초에서 30초 사이에서 자체적으로 길이를 선택합니다. 길이를 지정하지 않은 테스트 요청에서 10초 클립이 반환되었으며, 이는 5초 비용의 정확히 두 배입니다. 비용이 중요하다면 duration을 명시적으로 전달하십시오.
30초는 5초 비용의 6배입니다(720p 기준 ¥57.23 대 ¥9.60). 비용은 길이에 따라 엄격하게 증가하므로, 긴 클립을 생성하기 전에 5초로 prompt를 검증하십시오.

위 표와 앞부분의 2.0 표는 모두 0.18x의 SeeDance2 그룹에 속하므로 직접 비교할 수 있습니다. fast 및 mini에도 가격이 더 낮은 기간 한정 할인 그룹이 있으니 다음 섹션을 참조하십시오.

과금 참고 사항:

최종 청구 금액은 콘솔의 모델 가격과 호출 로그를 따릅니다.
작업은 제출 시 선청구되고 완료 시 정산됩니다. 잔액이 잠시 변동하므로 호출 로그와 대조하십시오. 동영상 하나는 두 개의 과금 항목을 생성합니다(아래의 “로그에서 과금 내역 읽기” 참조).
보류 금액은 해상도와 관계없이 길이만을 기준으로 합니다: 2.0 제품군은 초당 $0.09, 2.5는 초당 $0.135입니다. 따라서 1080p는 일반적으로 추가 금액이 청구된 상태로 정산되고 480p는 일반적으로 일부 환불됩니다. 둘 다 정상적인 동작입니다.
거부된 요청(HTTP 400 매개변수 오류 등)은 과금되지 않습니다(검증 완료).
비용은 길이에 따라 선형적으로 증가합니다. 15초 동영상은 5초 동영상의 약 3배 비용이 듭니다.

기간 한정 할인 그룹 (미니 / 고속 전용, 10/7까지)

2026-08-08에 두 개의 기간 한정 할인 그룹 출시: SD2Mini (0.10x 요율) 및 SD2Fast (0.15x 요율)입니다. 0.18x의 일반 SeeDance2 그룹과 비교하면 미니는 44.4%, 고속은 16.7% 할인입니다. 모델 기능, 파라미터, 엔드포인트 및 호출 구문은 변경되지 않습니다 — Token 하나만 교체하면 코드 수정이 필요 없습니다. 혜택은 **2026-10-07 23:59 (UTC+8)**까지 제공됩니다(Volcengine의 공식 프로모션에 맞춰 2026-09-05에 연장되었으며, 원래 종료일은 9월 7일이었습니다).

동일 조건 가격 비교 (위 측정 수치를 새 그룹 요율에 비례하여 환산한 값, 즉 0.18로 나눈 뒤 새 요율을 곱한 값입니다. CNY는 고정 환율 1:7로 변환했으며 참고용입니다):

모델	해상도 / 길이	일반 `SeeDance2` (0.18x)	할인 그룹	할인 청구액	할인율
`mini`	720p / 5초	$0.4508 (¥3.16)	`SD2Mini`	$0.2504 (¥1.75)	−44.4%
`mini`	480p / 4초	$0.1681 (¥1.18)	`SD2Mini`	$0.0934 (¥0.65)	−44.4%
`mini`	720p / 15초	$1.3451 (¥9.42)	`SD2Mini`	$0.7473 (¥5.23)	−44.4%
`fast`	720p / 5초	$0.7253 (¥5.08)	`SD2Fast`	$0.6044 (¥4.23)	−16.7%
`fast`	480p / 5초	$0.3373 (¥2.36)	`SD2Fast`	$0.2811 (¥1.97)	−16.7%
`fast`	720p / 4초	$0.5814 (¥4.07)	`SD2Fast`	$0.4845 (¥3.39)	−16.7%
`fast`	720p / 8초	$1.1568 (¥8.10)	`SD2Fast`	$0.9640 (¥6.75)	−16.7%

동일 모델, 동일 사양 기준으로 할인 그룹은 미니에서 44.4%, 고속에서 16.7%를 절감합니다. 이는 단순 그룹 요율 인하이며 충전 보너스와 별도로 중복 적용됩니다. 과금 방식은 변경되지 않으며, 실제 token 사용량을 기준으로 계속 정산되고 ±5% 편차는 정상입니다.

혜택 종료 후에도 중단되는 기능은 없습니다: 2026-10-07 23:59 (UTC+8) 이후에도 SD2Mini 및 SD2Fast는 계속 제공되며, 요율만 일반 SeeDance2 그룹과 동일한 0.18x로 돌아갑니다. Tokens는 계속 사용할 수 있으며 코드 변경도 필요 없습니다. 배치 프로덕션이 예정되어 있다면 할인 기간 내에 일정을 잡으십시오.

로그에서 과금 확인하기(사전 과금 + 정산)

api.apiyi.com/log에서 콘솔 로그 페이지를 열고 모델 이름 doubao-seedance-2-0를 검색하면 모든 과금 내역을 확인할 수 있습니다. 동영상 하나에는 두 개의 과금 항목이 생성됩니다.

사전 과금: 작업이 제출될 때 예상 금액이 차감됩니다(로그 항목에는 “비스트리밍”으로 표시되며, token과 그룹이 나타남) — 아래 스크린샷에서는 $0.449998입니다.
정산(과금 또는 환불): 작업이 완료된 후 실제 생성된 token을 기준으로 차액이 정산됩니다(완료 token 수가 표시된 “스트리밍” 로그 항목) — 아래에서는 $5.611858입니다. 1080p에서는 일반적으로 추가 과금이 발생합니다.

하나의 Seedance 2.0 동영상에 대한 두 과금 항목(사전 과금 및 정산)을 보여주는 APIYI 로그 페이지 — Two charge entries for one 15 s 1080p video: pre-charge + settlement

정산 항목에는 token이나 해당 그룹이 표시되지 않습니다 — 정상적인 동작입니다. 두 항목의 합계가 해당 동영상의 총 비용입니다.

시간 필드 읽는 방법:

첫 번째 항목(사전 과금)의 타임스탬프는 동영상의 제출 시간입니다. 해당 항목의 “첫 바이트” 값은 제출 요청이 작업 ID를 반환하는 데 걸린 시간입니다(예: 首字节:3秒 / 첫 바이트: 3초) — 생성 시간이 아닙니다.
정산 항목에는 流式(스트리밍) 및 首字节:<1秒(첫 바이트 1초 미만)이 표시됩니다 — 이는 정산 레코드의 내부 표시에 불과하며 문제가 발생했다는 의미가 아닙니다.
동영상의 실제 생성 시간은 상단 탐색 메뉴의 “비동기 작업” 페이지(api.apiyi.com/task)에서 “소요 시간”(耗时) 열로 확인할 수 있습니다.

로그 페이지에서 시간 및 첫 바이트 필드 읽기: 첫 번째 항목은 제출 시간과 제출 지연 시간을 나타냅니다 — 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

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

첫 번째 스크린샷의 15초 1080p 동영상의 총 비용은 0.449998 + 5.611858 = $6.061856입니다. 일치하는 작업 매개변수는 api.apiyi.com/task 상단의 “비동기 작업”에서 확인할 수 있으며, 과금 내역과 정확히 일치합니다.

{
  "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개의 완료 token은 ≈ 15 × 1248 × 1664 × 24 / 1024입니다(1080p의 3:4 동영상은 1248×1664를 출력함). 이는 과금 공식과 일치합니다.

이 15초 1080p 동영상의 총액은 약 ¥42.4입니다(고정 1:7 요율 기준 명목 과금). 충전 보너스를 적용하면 실질 비용은 약 ¥35~39로, 동일한 사양에 대한 공식 참고 가격인 약 ¥37.2와 비교할 수 있습니다. 공식 가격 자체가 저렴한 것은 아닙니다 — 비용은 모델 + 해상도 + 재생 시간에 따라 결정됩니다(빠른 모드 / 720p / 5초로 전환하면 훨씬 저렴합니다). 이 모델은 사용 가능성을 확보하기 위해 낮은 마진으로 공급되며, 큰 금액을 예치한 고객에게는 더 큰 할인이 제공됩니다.

베타 공급 안내: Seedance 2.5 및 2.0 제품군은 현재 베타 공급 단계에 있습니다. 실제 과금이 위 표와 눈에 띄게 다를 경우 고객 지원팀에 문의해 주시면 정산해 드립니다. 가격은 상위 제공업체의 정책(예: 이후 더 저렴한 공식 버전이 출시되는 경우)과 APIYI의 공급 역량에 따라 동적으로 조정됩니다. 역량을 갖춘 채널 파트너의 연락을 환영합니다. 이 모델의 가격은 공급을 확보하고 고객에게 서비스를 제공하기 위한 것이며, 수익 창출을 위한 것이 아닙니다.

그룹 설정

Seedance 2.5 및 2.0 계열은 전용 그룹에서 실행되며, 두 가지 필수 조건이 있습니다. ① 토큰의 과금 모델이 종량제 우선순위(또는 종량제)여야 합니다. 요청당 결제 토큰은 라우팅할 수 없습니다. ② 토큰에서 해당 그룹이 활성화되어 있어야 합니다. 기본 그룹 또는 다른 동영상 그룹의 토큰은 “이 모델에 사용 가능한 채널이 없습니다” 오류와 함께 실패합니다. 현재 세 개의 그룹이 있습니다. 2.5 및 2.0 계열은 SeeDance2을 공유하며, 정확히 하나의 모델만 제공하는 기간 한정 할인 그룹이 두 개 더 있습니다.

그룹	요율	제공 모델	비고
`SeeDance2`	0.18x	네 가지 모델 모두(2.5 / standard / fast / mini)	2.5 및 standard 모델로 가는 유일한 경로이며, 프로모션 종료 후의 대체 경로입니다 — 충분한 동시 실행 수, 대기열 없음
`SD2Mini`	0.10x	`doubao-seedance-2-0-mini-260615` 전용	🔥 기간 한정, 기존 요율 대비 44.4% 할인, 2026-10-07 23:59 (UTC+8)까지
`SD2Fast`	0.15x	`doubao-seedance-2-0-fast-260128` 전용	🔥 기간 한정, 기존 요율 대비 16.7% 할인, 2026-10-07 23:59 (UTC+8)까지

하나의 SeeDance2 토큰으로 네 가지 모델 모두에 접근할 수 있습니다: 2.5 및 세 가지 2.0 계열 모델이 모두 이 그룹에 있으므로, 코드에서는 model 필드만 변경하면 됩니다.두 할인 그룹은 단일 모델 채널입니다: SD2Mini은 mini만, SD2Fast은 fast만 제공하므로, 이를 통해 다른 모델을 호출하면 동일한 오류가 반환됩니다.프로모션 종료 시 중단되지 않습니다: 2026-10-07 23:59 (UTC+8) 이후에도 두 할인 그룹은 온라인 상태로 유지되며 요율만 0.18x로 돌아갑니다 — 토큰이나 코드 변경은 필요하지 않습니다.

2.5도 동일한 0.18x를 사용합니다. 세대 간 차이는 그룹 요율이 아니라 모델 자체의 단가(Volcengine의 2.5 가격이 2.0보다 높음)에서 발생합니다. 따라서 2.5와 2.0 계열은 정확히 동일한 환산 기준으로 실행됩니다.왜 0.18x인가요? 시스템에 내장된 Seedance 단가는 Volcengine의 공식 정가와 일치합니다. 그러나 해당 정가는 CNY 기준이고 APIYI 잔액은 USD 기준입니다(고정 환율 1:7 USD/CNY). 1x 요율을 적용하면 사실상 공식 금액의 7배가 청구되므로, 환율 변환을 반영하기 위해 그룹 요율을 낮춘 것입니다 — 0.18의 근거는 바로 이것이며, 할인도 가산도 아닙니다.Volcengine은 이 시리즈에 할인을 제공하지 않으며, 이 채널의 가격은 공급 확보를 위해 책정되었습니다. 기본 명목 청구액은 공식 기준 가격보다 약간 높지만, 충전 보너스가 대부분 이를 상쇄합니다. 대규모 충전 고객은 약 5%만 더 지불하며, 일부 등급(예: 1080p)은 공식 가격보다 낮습니다.유의 사항: 과금은 항상 실제 token 사용량을 기준으로 하며, token 환산에는 자연스러운 소폭 변동이 있습니다(±5%는 정상 범위). 공식 정가는 요청별 보장이 아닌 참조 기준점일 뿐입니다. 현재 가격은 공급 우선의 합리적인 구성입니다 — 반드시 충전 보너스와 함께 평가해 주십시오. 청구액이 이상해 보이면 언제든지 함께 청구 내역을 대조해 드릴 수 있습니다. 다만 “왜 공식 가격보다 약간 높은가”에 대해서는 논의 대상이 아니므로, 이 점을 유념하시고 우려된다면 이 채널을 이용하지 마십시오. 반대로, 이 채널이 제공하는 것은 바로 대기열 없는 충분한 동시 실행 수입니다.또한 에셋 라이브러리(가상 아바타 등록 / 실인물 인증)는 이 채널에서 무료로 포함됩니다. 공식적으로 별도 구매하려면 연간 수십만 CNY 규모의 계약이 필요합니다. 이것도 이 채널이 실제로 제공하는 가치의 일부입니다.

토큰 설정 방법

할인을 노리지 않는 경우: SeeDance2 그룹을 활성화한 토큰 하나를 생성하면 됩니다. 이 토큰으로 네 가지 모델 모두에 접근할 수 있으며, 아래 표는 건너뛰어도 됩니다. 기간 한정 할인을 이용하려는 경우: mini 및 fast에는 각각 전용 단일 모델 그룹이 있으므로, 아래와 같이 토큰을 분리하십시오.

토큰	기본 그룹	실행 대상
A (신규 · 할인)	`SD2Mini`	`doubao-seedance-2-0-mini-260615` 전용, 0.10x
B (신규 · 할인)	`SD2Fast`	`doubao-seedance-2-0-fast-260128` 전용, 0.15x
C (기존 · 메인)	`SeeDance2`	2.5 및 2.0 standard 모델, 10월 7일 이후 전체 2.0 계열이 여기로 대체됩니다

모든 토큰은 종량제 우선순위(또는 종량제) 과금 모델을 사용해야 합니다. mini만 사용하는 경우 토큰 A 하나면 충분하며, 2.5만 사용하는 경우 토큰 C 하나면 충분합니다 — 모두 만들 필요는 없습니다.

할인용 토큰을 별도로 만드는 것이 좋은 이유:

마감일을 놓치지 않습니다 — 토큰별로 과금이 분리되므로 프로모션 기간 동안 사용한 금액과 절감한 금액을 한눈에 확인할 수 있으며, 10월 7일이 다가올 때 배치 작업을 앞당길지 판단하기 쉽습니다
전환에 비용이 들지 않습니다 — 프로모션 종료 시 클라이언트를 토큰 C로 다시 지정하면 됩니다. 코드 변경이나 그룹 편집이 필요 없습니다
전용 토큰은 어차피 프로덕션 권장 방식입니다 — 업무 라인별 쿼터 제어 및 알림을 설정할 수 있고, 예상치 못한 급증도 훨씬 쉽게 추적할 수 있습니다

Seedance 2.5가 출시되었습니다(2026-08-28): 모델 이름은 doubao-seedance-2-5-260628이며, 2.0 계열과 동일한 SeeDance2 그룹(0.18x)에 있습니다. 엔드포인트, 인증 및 요청 형식은 2.0과 동일합니다 — model 필드만 바꾸면 코드가 계속 작동합니다. 2.0 계열과 비교하면 최대 길이는 15초 → 30초, 참조 이미지는 9개 → 30개, 참조 동영상/오디오는 3개 → 10개이며, 오디오는 단독으로도 사용할 수 있습니다. 또한 mov 출력과 omni_reference_task_type 작업 선택기가 추가되었습니다. 실행 비용은 2.0 standard 모델의 약 1.5배입니다. 전체 차이는 아래 “기술 사양”을 참조하십시오.

기술 사양

구분	Seedance 2.5	Seedance 2.0 제품군 (standard / fast / mini)
모델	`doubao-seedance-2-5-260628`	`doubao-seedance-2-0-260128` / `-fast-260128` / `-mini-260615`
해상도	480p / 720p / 1080p (4k 미지원)	480p / 720p / 1080p (1080p는 standard 전용, fast와 mini는 최대 720p)
동영상 코덱	1080p 출력은 H.265 (hvc1), 480p / 720p 출력은 H.264 (avc1)	H.264 (avc1)
화면비	오른쪽과 동일; 첫/마지막 프레임, 편집 및 확장은 `adaptive`을 강제함	`16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive` (기본값 적응형)
길이	4-30초의 정수 또는 `-1` 모델 선택 (기본값은 `-1`)	4-15초의 정수 또는 `-1` 모델 선택 (기본값 5)
프레임 레이트	고정 24 fps (`frames` 파라미터 미지원)	동일
출력 형식	`output_format`: `mp4` (기본값) 또는 `mov` (전문 후반 작업용 H.264 + yuv444p + PCM)	mp4만 지원
오디오	`generate_audio`의 기본값은 `true`, 모노	동일
레퍼런스 제한	이미지 30개 + 동영상 10개 + 오디오 클립 10개; 오디오만 레퍼런스로 사용할 수 있음	이미지 9개 + 동영상 3개 + 오디오 클립 3개; 오디오는 이미지 또는 동영상을 함께 제공해야 함
작업 유형 파라미터	`omni_reference_task_type`: `auto` / `edit` (동영상 편집) / `extend` (동영상 확장)	미지원
입력 이미지	jpeg/png/webp/bmp/tiff/gif/heic/heif; 화면비 (0.4, 2.5); 변 길이 (300, 6000) px; 각각 30 MB 미만	동일
생성 시간 (측정값)	480p/4초: 약 1.5-5분; 720p/5초: 약 2.5분; 720p/30초: 약 5.5분; 1080p/5초: 약 2.5분	5초 @720p: 약 2-5분; 1080p: 약 3분; 15초: 약 4.5분; mini는 더 빠름 (5초 @720p: 약 1.5-2.5분)
응답 필드	`content.video_url` (직접 링크, 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 (2.5 / 표준만 해당)
`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`	입력에 따라 모델이 위 값 중 하나를 선택합니다	동일	동일

2.5에서 480p 16:9는 864×496이 아니라 854×480입니다(측정값). 2.0에서 생성되는 864×496보다 픽셀 영역이 약간 작으므로 동일한 사양에서 비용이 드는 token도 약간 적습니다. 저희가 측정한 다른 모든 등급은 두 세대에서 일치합니다. 480p 1:1 = 640×640, 720p 16:9 = 1280×720, 720p 21:9 = 1470×630, 1080p 16:9 = 1920×1080입니다.이 제품군의 어떤 모델도 4k을 지원하지 않습니다. "resolution": "4k"을 전송하면 동기식 400이 반환되며 과금되지 않습니다.

적응형 작동 방식

텍스트-동영상: 모델이 prompt에서 가장 적합한 비율을 추론합니다.
첫 프레임+마지막 프레임 / 첫 프레임: 첫 프레임 이미지의 비율과 일치합니다(비율이 일치하지 않는 이미지는 중앙을 기준으로 잘립니다).
멀티모달 참조-동영상: prompt의 의도를 따르며, 그렇지 않으면 첫 번째 미디어 항목을 따릅니다(이미지보다 동영상이 우선합니다).
동영상 편집 / 확장(2.5): 출력 비율은 편집하거나 확장하는 입력 동영상에 따라 결정됩니다.
실제로 사용된 비율은 작업 응답의 ratio 필드에 반환됩니다.

ratio은 위의 7개 enum 값만 허용합니다. 예를 들어 "2:1"을 전달하면 InvalidParameter 오류가 반환되며(확인됨), 지원 범위를 벗어난 duration도 마찬가지입니다(2.5에서는 4~~30, 2.0 제품군에서는 4~~15). 둘 다 과금되지 않습니다.2.5에서는 세 가지 작업 유형에 대해 ratio: adaptive도 강제됩니다: 첫 프레임 / 첫 프레임+마지막 프레임 생성, 동영상 편집, 동영상 확장입니다. 이 경우 구체적인 화면 비율을 전달하면 제출 시점에 InvalidParameter.TaskTypeConstraint이 반환됩니다(측정 결과 동기식 400이며, 몇 분 후 실패하는 작업이 아닙니다).

모범 사례

출력 요구 사항에 따라 모델을 선택합니다

먼저 2.5에서만 제공되는 기능이 필요한지 확인합니다: 30초 클립, 참조 이미지 30개, 독립 오디오 참조, mov 출력 또는 명시적인 동영상 편집/확장 작업 유형이 이에 해당합니다. 이러한 기능 중 하나라도 필요하다면 doubao-seedance-2-5-260628을 선택합니다(표준 모델 가격의 약 1.5배이며, 2.0 제품군과 동일한 그룹입니다). 그렇지 않다면 2.0 제품군을 사용합니다. 배치 생성 및 비용에 민감한 워크로드에는 라이트 모델을 사용합니다 doubao-seedance-2-0-mini-260615 (표준 가격의 약 절반이며 가장 빠르게 생성되고, 최대 720p로 제한됩니다). 1080p 또는 최고 품질이 필요하면 표준 모델을 사용하고, fast은 중간 선택지입니다.

먼저 이미지와 동영상을 에셋 ID로 수집합니다

요청에 미디어가 포함되면 작업 생성 지연 시간은 해당 미디어를 업로드하는 데 걸리는 시간에 좌우됩니다. 인라인 Base64 또는 대용량 이미지 URL을 사용하면 제출 시간이 약 1초에서 수십 초로 늘어나거나 읽기 시간 초과가 발생할 수 있습니다. 먼저 미디어를 수집하고 asset:// 에셋 ID를 받은 다음 이를 참조합니다. 그러면 요청 본문이 수십 바이트로 줄어들고, 작업 ID가 즉시 반환되며, 콘텐츠 검사가 수집 시점으로 앞당겨집니다. 에셋 우선 워크플로를 참조하십시오.

크롭을 방지하려면 적응형을 사용합니다

이미지-동영상 변환에서는 모델이 소스 이미지의 비율에 맞추도록 기본값인 adaptive을 유지합니다. 대상 플랫폼에서 요구하는 경우에만 9:16(세로) 또는 16:9(가로)로 고정합니다.

길이를 조절하여 비용을 관리합니다

비용은 길이에 따라 엄격하게 증가합니다. 먼저 5초 클립으로 프롬프트를 검증한 다음 길이를 늘립니다(2.5는 최대 30초까지 지원하며, 비용은 5초 클립의 6배입니다). 2.5에서는 항상 duration을 명시적으로 전달해야 합니다. 기본값은 -1이므로 생략하면 모델이 선택하며, 테스트에서는 10초를 선택하여 비용이 두 배로 증가했습니다.

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

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으로 클립을 연결합니다

return_last_frame: true을 설정하면 워터마크가 없는 마지막 프레임 PNG를 받을 수 있습니다. 그런 다음 이를 다음 작업의 첫 번째 프레임으로 사용하여 연속적인 여러 클립 동영상을 제작합니다.

오류 코드 및 재시도

코드	의미	권장 처리
`400`	`InvalidParameter`: 잘못된 해상도/비율/길이(예: fast 또는 mini + 1080p, 모든 모델 + 4k, 2.5 + `duration: 31`)	메시지에 문제가 있는 매개변수가 표시됩니다. 위 표에 따라 수정하십시오. 과금되지 않습니다.
`400`	`InvalidParameter.TaskTypeConstraint` (2.5만 해당): 매개변수가 작업 유형과 충돌합니다.	첫 프레임/마지막 프레임, 편집 및 확장 작업에서는 `ratio`을(를) `adaptive`(으)로 설정하십시오. 편집 작업에서는 `duration`을(를) `-1`(으)로 설정하십시오. 과금되지 않습니다.
작업 `failed` + `InvalidParameter.TaskTypeMismatch`	2.5만 해당: 선언된 `omni_reference_task_type`이(가) 모델이 prompt에서 추론한 작업 유형과 일치하지 않습니다.	의도한 작업에 맞게 prompt를 조정하십시오(편집: 추가 / 제거 / 교체, 확장: 확장 / 계속). 또는 `auto`(으)로 전환하십시오.
`401`	유효하지 않은 Token	Bearer Token을 확인하십시오.
`403`	콘텐츠 조정 거부(실제 얼굴, 정책 위반)	에셋 또는 prompt를 변경하십시오.
`429`	요청 제한 초과 / 쿼터 부족	지수 백오프를 적용하고 잔액을 확인하십시오.
`5xx`	게이트웨이 / 백엔드 오류	1~2회 재시도하십시오.
작업 `failed`	생성 실패	작업의 오류 필드를 확인하고, 필요한 경우 다른 seed로 재시도하십시오.
작업 `expired`	`execution_expires_after` 초과(기본값 48시간)	다시 제출하십시오.

클라이언트 권장 사항:

생성/폴링 호출에는 30~60초 요청 타임아웃이면 충분합니다(대기는 작업 측에서 수행됩니다).
15~30초마다 폴링하고 전체 예산을 15분 이상으로 설정하십시오(1080p / 15초 작업은 더 길게 설정).
5xx 및 타임아웃에 지수 백오프를 적용하십시오(2회 재시도).
문제 해결을 위해 작업 id 및 x-request-id 응답 헤더를 기록하십시오.

FAQ

이미지나 동영상이 포함된 요청에서 작업 ID가 반환되기까지 너무 오래 걸리거나 시간 초과가 발생하는 이유는 무엇입니까?

느린 것은 생성이 아니라 제출입니다. 미디어가 먼저 APIYI로 업스트림 전송된 다음 Volcengine으로 전달되고, 그곳에서 디코딩 및 검증이 이루어집니다. 이 모든 과정이 끝난 후에야 작업 ID가 반환됩니다. 인라인 Base64나 대용량 이미지 URL을 사용하면 이 단계가 약 1초에서 수십 초로 늘어나며, 60초의 클라이언트 읽기 시간 제한으로도 충분하지 않을 수 있습니다. 생성 자체는 일반적으로 2~5분이 걸리며, 이는 제공업체의 정상적인 속도로 제출 과정과는 관련이 없습니다.실제 해결 방법은 먼저 미디어를 수집한 후 asset:// asset ID로 참조하는 것입니다. 그러면 요청 본문이 메가바이트 단위에서 수십 바이트로 줄어듭니다. 지연 시간 분석, 마이그레이션 단계, 시간 초과 후 작업이 생성되었는지 확인하는 방법은 Asset-First Workflow를 참조하십시오.

Seedance 2.5와 2.0 중 무엇을 사용해야 합니까?

필요한 기능을 기준으로 선택하십시오. 2.5가 자동으로 기본 선택되는 것은 아닙니다. 2.0 표준 모델보다 약 1.5배의 비용으로 실행됩니다(720p/5초: $1.3721 대 $0.9074). 이는 Volcengine 자체 정가표의 가격 차이와 일치합니다.다음과 같은 경우 2.5를 사용하십시오. 15초보다 긴 클립이 필요하거나(2.5는 30초 지원), 참조 이미지가 9개보다 많거나(2.5는 30개 지원), mov 출력이 필요하거나, 제출 시 파라미터 오류가 표시되는 동영상 편집 / 확장이 필요한 경우입니다(omni_reference_task_type). 또한 2.5는 오디오만 참조로 사용하는 것을 허용하지만, 2.0에서는 오디오와 함께 이미지나 동영상도 필요합니다.클립이 15초 미만이라면 2.0 제품군을 계속 사용하십시오. 표준 모델은 1080p도 지원하며 동일한 플래그십 품질 등급에 속합니다. 비용에 민감한 일괄 제작에는 표준 단가의 약 절반 가격이며 생성 속도가 가장 빠른 mini를 사용하십시오. 2.0 제품군은 지원 종료되지 않습니다.엔드포인트, 인증, 요청 형식은 세대 간에 동일하며, 그룹도 동일합니다. 전환하려면 필드 하나만 변경하면 됩니다: model.

2.5는 1080p를 지원합니까? 4k는 어떻습니까?

1080p는 정상적으로 작동합니다(측정 결과: 1920×1080으로 정상 렌더링됨). 4k는 지원되지 않습니다. "resolution": "4k"를 전송하면 동기식 400 오류가 반환됩니다(과금되지 않음).쉽게 놓칠 수 있는 차이점이 하나 있습니다. 2.5는 1080p를 H.265(hvc1)로 인코딩하는 반면, 480p와 720p는 H.264(avc1)를 사용합니다. H.265 파일은 더 작지만 구형 플레이어, 일부 브라우저 및 특정 편집 제품군에서는 H.264보다 안정적으로 처리되지 않을 수 있습니다. 1080p를 배포하기 전에 다운스트림 파이프라인에서 해당 형식을 디코딩할 수 있는지 확인하십시오.

2.5에서 동영상 편집 및 동영상 확장을 어떻게 실행합니까?

두 작업 모두 “옴니 참조” 작업이며, content의 참조 동영상과 프롬프트에 표현된 의도로 트리거됩니다. 오류가 조기에 표시되도록 omni_reference_task_type를 명시적으로 전달하십시오.

동영상 편집: omni_reference_task_type: "edit", 최소 하나의 role: "reference_video", ratio는 adaptive이어야 하고 duration는 -1이어야 하며, 소스 동영상의 길이는 4~30초여야 합니다. 프롬프트에는 편집 동사(add, remove, delete, change, replace)가 필요합니다. 출력 비율과 길이는 입력 동영상을 따르며, 길이는 소수일 수 있습니다(측정 실행에서 16.709초가 반환됨).
동영상 확장: omni_reference_task_type: "extend"이며, 다시 참조 동영상과 함께 ratio를 adaptive으로 설정해야 합니다. 프롬프트에는 확장 동사(extend, continue)가 필요합니다.

프롬프트에서 에셋을 위치 기준으로 참조하십시오(@video1, @image1). 전달한 순서대로 참조해야 합니다. 잘못된 파라미터는 작업이 몇 분 후 실패하는 대신 제출 시 400 오류를 반환합니다(InvalidParameter.TaskTypeConstraint).

2.5의 mov 출력 형식은 어떤 용도입니까?

"output_format": "mov"를 전달하면 더 높은 색상 및 휘도 충실도를 제공하는 QuickTime 컨테이너(H.264 + yuv444p 크로마 + PCM 오디오)가 반환됩니다. 이는 색보정, 키잉, 합성에 적합하며, 동영상 편집 / 확장 작업에서는 입력과 출력 모두에 공식적으로 권장됩니다. 기본값은 mp4이며, 호환성이 가장 넓습니다.mov는 일부 플레이어에서 열 수 없는 전문가용 코덱을 사용한다는 점에 유의하십시오(VLC, mpv, ffplay 및 macOS의 IINA에서는 모두 처리 가능). 웹이나 모바일에 직접 배포하려면 기본값인 mp4를 계속 사용하십시오.

'이 모델에 사용 가능한 채널이 없습니다'라는 메시지가 표시되는 이유는 무엇입니까?

가장 흔한 Seedance 오류이며, 10번 중 9번은 Token에 잘못된 그룹이 활성화되어 있기 때문입니다. 오류에는 현재 사용 중인 그룹이 표시됩니다. 예를 들면 다음과 같습니다.

Current group SeeDance2 has no available channels
for model doubao-seedance-2-5-260628

모델을 해당 그룹에 맞추고 Token Settings에서 활성화하십시오.

호출 중인 모델	활성화할 그룹
`doubao-seedance-2-5-260628`	`SeeDance2`
`doubao-seedance-2-0-260128`	`SeeDance2`
`doubao-seedance-2-0-fast-260128`	`SeeDance2` 또는 `SD2Fast`
`doubao-seedance-2-0-mini-260615`	`SeeDance2` 또는 `SD2Mini`

SeeDance2이 활성화된 하나의 키로 네 모델 모두에 연결할 수 있습니다. 과금 모델도 Pay-as-you-go Priority 또는 Pay-as-you-go여야 합니다. Pay-per-request Token은 라우팅할 수 없습니다.

Python requests에서 gzip 오류가 발생하거나 잘린 비JSON 본문이 반환됩니다

게이트웨이의 content-encoding: gzip 헤더가 실제 본문 인코딩과 일치하지 않습니다. 증상으로는 ContentDecodingError, 잘린 비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에서 마이그레이션할 때 쉽게 발생하는 실수입니다.

이미지-동영상 변환에 실제 사람의 사진을 업로드할 수 있습니까?

아니요. Seedance 2.5와 2.0 제품군 모두 실제 사람의 얼굴이 포함된 참조 이미지/동영상을 허용하지 않습니다(업스트림 콘텐츠 안전 정책). 대안으로는 최근 30일 이내에 Seedance 모델로 생성된 얼굴 포함 출력을 재사용하거나, 플랫폼의 사전 설정 가상 아바타(asset:// ID)를 사용하거나, 라이선스가 있는 얼굴 에셋을 사용하십시오.

에셋 라이브러리를 사용하려면 추가 비용이 듭니까?

아니요. 가상 아바타 수집, 실제 인물 확인 및 나머지 비공개 에셋 라이브러리는 APIYI의 Seedance 2.0 API에서 무료이며 연회비도 없습니다. 공식적으로 이 기능은 별도 구매 애드온입니다. 프레임워크 계약이 없는 고객의 경우 연간 수십만 위안 규모의 CNY 계약이 필요하며, Volcengine에서도 직접 판매합니다. APIYI는 장기 사용자를 중요하게 생각하므로 해당 비용은 이미 API 가격에 포함되어 있습니다. SD2 API를 일반적인 업무 규모로 사용하는 고객에게는 추가 요금이 없습니다. 사용 방법은 Asset Library를 참조하십시오.

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

파라미터 거부(HTTP 400)는 과금되지 않습니다(확인됨). 제출 시 선결제되고 완료 시 정산되므로 잔액이 잠시 변동될 수 있습니다. 호출 로그를 기준으로 대조하십시오.

토큰 사용량을 어떻게 추정합니까? 세로 영상이 더 비쌉니까?

tokens ≈ duration(s) × width × height × 24 / 1024이며, 오차 0.1% 이내로 확인되었습니다. 한 등급 내에서는 모든 비율의 픽셀 면적이 동일합니다(720p 16:9와 9:16 모두 5초당 108,900 token). 따라서 가로, 세로, 정사각형 모두 비용이 동일합니다.

2.0 제품군에서는 표준, fast, mini 중 무엇을 사용해야 합니까?

가격과 속도는 mini < fast < standard 순입니다(플랫폼 내 720p/5초 기준 가격: 약 ¥3.16 / ¥5.08 / ¥6.35). 일괄 제작 및 비용에 민감한 작업에는 mini를 선택하십시오. 표준 가격의 약 절반이며 생성 속도가 가장 빠릅니다(2026-07 측정: 720p에서 5초 생성에 약 1.5~2.5분). 최대 세부 묘사가 필요하면 standard를, 중간 지점을 원하면 fast를 선택하십시오. mini와 fast는 모두 720p로 제한되며, 1080p를 요청하면 400 파라미터 오류가 반환됩니다(과금되지 않음).1080p만 필요하다면 2.0 표준 모델에서 이미 지원합니다. 이 기능만을 위해 업그레이드할 필요는 없습니다. 30초 클립, 9개를 초과하는 참조 이미지, mov 출력 또는 동영상 편집/확장이 필요하면 2.5로 전환하십시오(표준 모델 가격의 약 1.5배이며 2.0 제품군과 동일한 그룹을 사용).

duration: -1은 어떤 기능을 합니까?

모델이 자체적으로 길이를 선택하고(2.5에서는 4~~30초, 2.0 제품군에서는 4~~15초) 실제 출력 길이를 기준으로 과금합니다. 최종 길이는 작업의 duration 필드에 반환됩니다.-1는 2.5의 기본값입니다(2.0 제품군의 기본값은 5초). 따라서 duration를 생략하면 모델 선택 길이를 사용하게 되며, 측정된 2.5 요청에서 duration을 지정하지 않자 정확히 5초의 두 배 비용인 10초 클립이 반환되었습니다. 비용 예측 가능성이 중요하다면 duration를 명시적으로 전달하십시오.

frames 파라미터는 소수 초를 지원합니까?

아니요. frames와 camera_fixed은 Seedance 1.x 파라미터이며 Seedance 2.5와 2.0 시리즈 모두에서 지원되지 않습니다. 대신 초 단위 정수인 duration을 사용하십시오.

첫 프레임+마지막 프레임, 첫 프레임 및 참조 이미지를 혼합할 수 있습니까?

아니요. 세 가지 상호 배타적인 모드입니다. 첫 프레임+마지막 프레임(first_frame/last_frame 역할이 필수인 이미지 2개), 첫 프레임(이미지 1개), 멀티모달 참조-동영상 변환(이미지 역할 reference_image)입니다. “첫 프레임/마지막 프레임 + 참조”를 근사하려면 참조 모드를 사용하고 프롬프트에서 프레임을 지정하십시오.참조 제한은 세대별로 다릅니다. 2.5는 이미지 30개 + 동영상 10개 + 오디오 클립 10개를 지원하며 오디오만 단독으로 사용할 수 있습니다. 2.0 제품군은 이미지 9개 + 동영상 3개 + 오디오 클립 3개를 지원하며, 오디오를 사용하는 경우 이미지 1개 또는 동영상 1개 이상이 함께 필요합니다.

동시 실행 수 제한이나 대기열이 있습니까?

SeeDance2 그룹은 동시 실행 수가 충분하고 대기열이 없습니다(테스트에서 15개의 동시 작업이 모두 즉시 실행됨). 더 큰 규모의 지속적인 작업이 필요하면 영업팀에 문의하십시오.

프롬프트에 제한이 있습니까?

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

​개요

동영상 생성 API 레퍼런스

API 매뉴얼

시각적 API 테스트

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

​AI 에이전트에게 통합을 맡기기

​APIYI의 Seedance는 왜 사용합니까?

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

가상 얼굴 화이트리스트 액세스

에셋 라이브러리 무료 포함

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

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

마찰 없는 액세스 · 신원 인증 없음

전체 동영상 모델 라인업

전문 지원

​주요 기능

3가지 티어 · 티어별 동일 가격

기본 동기화 오디오

최대 30초의 제어 가능한 길이

다국어 prompt

첫+마지막 / 첫 프레임

멀티모달 참조-동영상

비동기 작업 흐름

재현 가능한 시드

​가격

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

​Seedance 2.5 가격(SeeDance2 그룹, 0.18x)

​기간 한정 할인 그룹 (미니 / 고속 전용, 10/7까지)

​로그에서 과금 확인하기(사전 과금 + 정산)

​그룹 설정

​토큰 설정 방법

​기술 사양

​API 엔드포인트

​해상도 및 화면 비율 상세 설명

​적응형 작동 방식

​모범 사례

​오류 코드 및 재시도

​FAQ

​관련 문서

개요

AI 에이전트에게 통합을 맡기기

APIYI의 Seedance는 왜 사용합니까?

주요 기능

가격

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

Seedance 2.5 가격(`SeeDance2` 그룹, 0.18x)

기간 한정 할인 그룹 (미니 / 고속 전용, 10/7까지)

로그에서 과금 확인하기(사전 과금 + 정산)

그룹 설정

토큰 설정 방법

기술 사양

API 엔드포인트

해상도 및 화면 비율 상세 설명

적응형 작동 방식

모범 사례

오류 코드 및 재시도

FAQ

관련 문서