메인 콘텐츠로 건너뛰기

​
개요

doubao-seedance-2-5-260628(2.5), doubao-seedance-2-0-260128(표준), doubao-seedance-2-0-fast-260128(fast), doubao-seedance-2-0-mini-260615(mini/lite)는 바이트댄스의 최신 동영상 생성 모델 패밀리입니다. 병렬로 실행되는 네 가지 모델로 구성되어 있으며, BytePlus 해외 버전이 아닌 공식 Volcengine 중국 본토 리소스를 통해 APIYI에서 업스트림 콘텐츠 안전 기능이 내장된 상태로 제공됩니다. 이 모델들은 텍스트 투 비디오, 첫 프레임 및 시작+끝 프레임 이미지 투 비디오, 멀티모달 참조 투 비디오를 지원하며, 영상과 동기화된 음성, 음향 효과 및 배경 음악을 생성할 수 있습니다. 2.5는 가장 강력한 성능을 갖춘 티어입니다: 최대 생성 시간이 15초에서 30초로 늘어났고, 참조 이미지는 9개에서 30개로 증가했으며, 오디오를 단독 참조로 활용할 수 있고, mov 출력과 명시적인 동영상 편집/확장 태스크 유형이 추가되었습니다. 비용 또한 더 높습니다 — 720p/5초 기준으로 2.0 표준 모델의 약 1.5배($0.91 대비 약 $1.35)이며, 이는 Volcengine 자체 정가에서 두 세대 간에 나타나는 가격 차이와 일치합니다. 2.0 패밀리는 계속 제공되며 서비스가 중단되지 않습니다. 15초 미만의 일상적인 클립의 경우 표준 모델이 더 저렴하며 1080p도 지원합니다. mini는 대량 제작을 위한 선택지이며(표준 모델 단가의 약 절반 수준이자 더 빠른 생성 속도, 최대 720p 지원), fast는 그 중간에 위치합니다. 2.5는 2.0 패밀리와 동일한 SeeDance2 그룹(0.18x)에서 실행됩니다 — 하나의 token으로 4개 모델을 모두 이용할 수 있습니다. 아래 “그룹 설정”을 참조하십시오.
🎬 주요 특징: 2.5는 4~30초, 2.0 패밀리는 4~15초를 지원합니다(두 모델 모두 모델이 결정하는 길이를 위해 -1 값을 허용함). 3가지 해상도 티어(480p/720p/1080p, 단 1080p는 2.5 및 2.0 표준 모델로 제한됨), 6가지 화면비 및 적응형 화면비, 기본적으로 활성화된 동기화 오디오, 다국어 prompt를 지원합니다. 대규모 숏폼 동영상 제작, 이커머스 리소스, 모션 디자인, 가상 인간 콘텐츠에 최적화되어 있습니다.
2.5를 호출하는 token에는 SeeDance2 그룹이 필요합니다(요율 0.18x) — 2.0 패밀리와 동일한 그룹입니다. Default 그룹이나 다른 동영상 그룹의 token으로 doubao-seedance-2-5-260628을 호출하면 “no available channel for this model” 오류와 함께 실패합니다.SeeDance2이 활성화된 하나의 token으로 4개 모델을 모두 이용할 수 있습니다 — 2.5와 2.0 패밀리는 동일한 그룹과 동일한 요율을 공유하므로, 코드에서 model 필드만 변경하면 됩니다.

동영상 생성 API 레퍼런스

POST /seedance/api/v3/contents/generations/tasks — 인터랙티브 Playground와 전체 폴링/다운로드 코드가 포함된 비동기 태스크 엔드포인트입니다.

API 매뉴얼

token 생성, 베이스 URL, 과금 모델 및 일반적인 호출 규칙을 다룹니다.

시각적 API 테스트

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

비동기 태스크 조회 / 다운로드

APIYI 콘솔에서 제출된 동영상 태스크를 확인하고 동영상 링크를 다운로드할 수 있는 API 외부 조회 경로입니다.

​
AI 에이전트에게 연동 맡기기

이 prompt를 복사하여 Codex / Claude Code / Cursor에 붙여넣으십시오

먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 문서 URL 끝에 .md 추가), 프로젝트 고유의 기술 스택으로 코드를 작성합니다. 비동기 폴링, 즉시 복사를 유도하는 24시간 링크 만료, gzip 헤더 함정, 매개변수 제약 조건 등이 이미 요구사항에 반영되어 있습니다.

이 프로젝트에 Seedance 2.5 / 2.0 동영상 생성(텍스트-동영상, 첫 프레임/마지막 프레임, 멀티모달 참조, 동영상 편집, 동영상 확장)을 연동하거나 문제를 해결하십시오.

코드를 다루기 전에 문서를 읽으십시오. 이 페이지의 일반 텍스트 버전을 확인하려면 https://docs.apiyi.com/en/api-capabilities/seedance2/overview.md 를 가져오십시오. 엔드포인트 세부 정보는 video-generation 페이지를 참조하십시오…

  1. 동기식 대기가 아닌 3단계 비동기 흐름을 사용하십시오. POST /seedance/api/v3/contents/generations/tasks에 제출하여 작업 ID를 받은 후 폴링하십시오…

총 9개의 요구사항이 있습니다. 아래 버튼을 사용하여 전체 prompt를 복사하십시오.

​
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은 이 시리즈에 할인을 제공하지 않으며, 이 채널은 수익을 위한 것이 아니라 공급 확보를 위한 순수 공식 릴레이입니다. 가격은 “대규모 예치 고객의 20% 보너스”를 기준으로 설정됩니다. 명목 과금은 공식 가격의 1.26배(0.18 요율 × 고정 1:7 환율)이며, 20% 충전 보너스 적용 후에는 공식 가격의 약 1.05배가 됩니다. 이 5%의 프리미엄은 주로 특별 세금계산서 발행에 따른 6% VAT 비용을 충당합니다. 10% 보너스를 받는 일반 고객의 경우 약 1.15배가 됩니다. 과금은 영역×기간을 기준으로 하므로 ±5%의 편차는 정상 범위입니다 — 언제든 테스트하고 대조한 후 문의하시기 바랍니다.단가 외에도 이 채널은 두 가지를 추가로 제공합니다. 허용 목록에 등록된 계정은 실제 사람 얼굴을 생성할 수 있으며(공식적으로는 기본 차단됨), 캐릭터 일관성을 유지하는 동영상에 필요한 에셋 라이브러리가 APIYI에서 무료로 포함됩니다(공식적으로는 별도 구매 애드온이며, 프레임워크 계약이 없는 고객의 경우 연간 수십만 위안 규모의 계약이 필요합니다). 두 항목 모두 위의 단가 비교에는 반영되지 않았습니다.
token 기반 과금: tokens ≈ (input video duration + output duration)(s) × output width × output height × 24 / 1024 (텍스트-/이미지-대-동영상의 경우 입력 동영상 기간은 0이며, 내부 테스트에서 0.1% 이내로 검증되었습니다). 한 등급 내 모든 비율의 픽셀 영역이 동일하므로 가격은 해상도 등급, 출력 기간, 입력에 동영상이 포함되는지 여부에 따라서만 결정됩니다.

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

① 입력 동영상 없음 (텍스트-동영상 / 이미지-동영상 / 참조 이미지): ② 입력 동영상 있음 (video_url를 포함한 멀티모달 참조; 입력 동영상 215초, 낮은 범위 ≈ 24초 입력, 높은 범위 ≈ 15초 입력):
표 ②의 모든 가격은 여전히 5초 출력 기준입니다. 범위는 입력 동영상 길이(2~15초)만 반영한 것입니다. CNY 30.13은 “5초 출력 + 15초 입력”이며, 15초 출력이 아닙니다. 입력 동영상이 있는 경우 청구 기간 = 입력 동영상 기간 + 출력 기간이며, 양쪽 모두 출력 해상도의 프레임으로 변환됩니다. 또한 최소 token 기준값이 적용되므로 매우 짧은 입력은 기준값으로 청구됩니다. 기준이 되는 사용량은 반환된 usage.completion_tokens입니다.계산 예시 (표준 모델, 1080p, 12초 출력 + 12초 참조 동영상): 1080p는 프레임당 1920 × 1080 ÷ 1024 = 2025 tokens입니다. 출력은 24 × 12 + 1 = 289프레임이고 입력 프레임 288개를 더하면 총 577 × 2025 = 1,168,425 tokens입니다. 공식 입력 동영상 포함 요율인 1K tokens당 약 CNY 0.031을 적용하면 대략 CNY 36.2입니다. APIYI의 명목 청구액은 $6.52(CNY 45.6)이며, 20% 보너스 적용 후 대규모 입금 고객의 금액은 약 CNY 38.0입니다. 출력이 5초가 아니므로 이 작업은 표 ②의 어떤 셀에도 해당하지 않습니다.
플랫폼 측정 비교 (2026-06 및 2026-07 테스트, 16:9 / 기본 오디오 / 입력 동영상 없음; 참고용으로 고정 1:7 환율을 적용한 CNY): 플랫폼 측정(입력 동영상 있음) (2026-09-12 테스트, 표준 모델 1080p / 9:16 / 오디오 없음 / 12초 참조 동영상; 고정 1:7 환율을 적용한 CNY): 입력 동영상에는 별도의 더 낮은 token 요율이 적용됩니다(이 1080p 실행에서는 동영상이 없는 1080p의 100만 tokens당 $8.28에 비해 $5.58로 측정됨). 그러나 입력 동영상의 모든 1초가 출력 해상도에 따라 tokens로 변환되어 출력과 함께 청구되므로 총액은 일반적으로 더 높습니다. 비용을 절약하려면 해상도를 낮추기 전에 먼저 참조 동영상을 잘라내십시오.
세 모델의 가격은 동일하지 않습니다 — 절대로 동일하게 취급하지 마십시오. 동일한 해상도와 기간에서 token당 가격은 Mini < 빠른 < 표준 순서입니다(예: 720p/5초: Mini ≈ ¥3.16, 빠른 ≈ ¥5.08, 표준 ≈ ¥6.35). 이는 공식 가격 체계와 일치합니다. 일괄 제작에서는 Mini가 비용과 시간을 가장 많이 절약합니다(2026-07 테스트에서 유효 단가는 플랫폼의 명목 요율과 정확히 일치하여 편차가 0.00%로 측정됨). 1080p는 표준 모델만 지원합니다.
참고: “CNY”는 플랫폼의 표시 청구액입니다. “일반 ÷1.1” 및 “대규모 고객 ÷1.2”는 10% / 20% 충전 보너스 적용 후의 실질 가격입니다. 보너스 적용 후 대규모 입금 고객은 공식 기준 가격의 약 1.05배, 일반 고객은 약 1.15배를 지불합니다. 기준이 되는 사용량은 반환된 usage.completion_tokens입니다.

​
Seedance 2.5 요금 (SeeDance2 그룹, 0.18x)

2.5 버전과 2.0 제품군은 동일한 SeeDance2 그룹과 동일한 0.18x 요율을 공유하며, 세대 간의 차이는 전적으로 모델 자체의 단가에서 비롯됩니다. 720p/5초 기준 요금은 2.0 표준 모델의 경우 $0.9074인 반면, 2.5에서는 $1.3721로 약 1.5배입니다. 이 차이는 Volcengine 자체 정가를 그대로 반영한 것(2.5의 token 요율이 2.0 대비 약 52% 높음)이며, APIYI의 마크업이 아닙니다. 업그레이드할 가치가 있는지는 30초 클립, 30장의 참조 이미지, mov 출력 또는 동영상 편집/확장 기능이 실제로 필요한지에 따라 결정됩니다. 이러한 기능이 필요하지 않다면 2.0 표준 모델이 더 저렴하며 1080p 또한 지원합니다. ① 입력에 동영상이 없는 경우 (텍스트-동영상 생성, 이미지-동영상 생성, 참조 이미지): ② 입력에 동영상이 포함된 경우 (video_url를 사용한 멀티모달 참조, 동영상 편집, 동영상 확장): 별도의 더 낮은 token 요율로 과금됩니다. 요율이 낮다고 해서 청구 금액이 반드시 적어지는 것은 아닙니다. 입력에 동영상이 포함되면 과금 대상 tokens = (입력 동영상 재생 시간 + 출력 재생 시간) × 면적이 되므로 token 수 자체가 증가합니다. 위 행의 경우 요율 ①을 적용하면 $1.0945이지만, 요율 ②를 적용하면 $0.6567입니다. 두 가지 token 요율: token 수와 두 요율 모두 단순 요율 계산이 아닌 실제 과금 로그(2026-08-31 재확인)를 기반으로 산정되었습니다. 충전 보너스를 중첩 적용하면 고액 충전 고객은 공식 참조 가격에 근접한 요금으로 이용할 수 있습니다.
2.5에서 비용이 과다 지출되기 쉬운 세 가지 원인:
  1. duration의 기본값이 -1로 지정되어 있습니다(2.0 제품군의 기본값은 5입니다). 이 값을 생략하면 2.5는 4초에서 30초 사이의 길이를 자체적으로 선택합니다. 실제로 재생 시간을 지정하지 않은 테스트 요청에서 10초 클립이 반환되어 5초 비용의 정확히 2배가 청구되었습니다. 비용 관리가 중요하다면 duration를 명시적으로 전달하십시오.
  2. 30초는 5초 비용의 6배입니다(720p 기준 ¥57.23 vs ¥9.60). 비용은 재생 시간에 정확히 비례하므로 긴 클립을 생성하기 전에 먼저 5초로 prompt를 검증하십시오.
  3. 참조 동영상의 재생 시간도 함께 과금됩니다. video_url를 사용하면 2.0과 2.5 모두에서 입력 동영상의 매 초가 출력 해상도 기준의 tokens로 변환되어 출력과 함께 정산됩니다. 사전 청구 금액은 출력 재생 시간만을 기준으로 계산되므로 이러한 작업의 최종 정산 금액은 사전 청구 금액의 몇 배에 달하는 경우가 많습니다. 이는 정상적인 현상입니다.
위의 표와 상단의 2.0 표는 모두 0.18x의 SeeDance2 그룹 기준이므로 직접 비교할 수 있습니다.
과금 안내:
  • 최종 청구 금액은 콘솔의 모델 요금 및 호출 로그를 따릅니다.
  • 작업 제출 시 사전 청구되며 완료 시 정산됩니다 — 잔액이 일시적으로 변동될 수 있습니다. 하나의 동영상에 대해 두 개의 청구 항목이 생성되는 호출 로그를 통해 대조하십시오(아래의 “로그에서 청구 내역 확인하기” 참조).
  • 사전 청구 금액은 해상도와 무관하게 오직 재생 시간만을 기준으로 책정됩니다: 2.0 제품군은 초당 $0.09, 2.5는 초당 $0.135입니다. 따라서 1080p는 보통 추가 정산금이 발생하고 480p는 보통 부분 환불이 발생하며, 이는 둘 다 정상입니다.
  • 거부된 요청(HTTP 400 매개변수 오류 등)에 대해서는 과금되지 않습니다(확인 완료).
  • 비용은 재생 시간에 정비례합니다. 15초 동영상은 5초 동영상보다 약 3배의 비용이 발생합니다.

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

api.apiyi.com/log에서 콘솔 로그 페이지를 열고 모델 이름 doubao-seedance-2-0를 검색하면 모든 과금 내역을 확인할 수 있습니다. 동영상 하나에는 두 개의 과금 항목이 생성됩니다.
  1. 사전 과금: 작업이 제출될 때 예상 금액이 차감됩니다(로그 항목에는 “비스트리밍”으로 표시되며, token과 그룹이 나타남) — 아래 스크린샷에서는 $0.449998입니다.
  2. 정산(과금 또는 환불): 작업이 완료된 후 실제 생성된 token을 기준으로 차액이 정산됩니다(완료 token 수가 표시된 “스트리밍” 로그 항목) — 아래에서는 $5.611858입니다. 1080p에서는 일반적으로 추가 과금이 발생합니다.
하나의 Seedance 2.0 동영상에 대한 두 과금 항목(사전 과금 및 정산)을 보여주는 APIYI 로그 페이지

Two charge entries for one 15 s 1080p video: pre-charge + settlement

정산 항목에는 token이나 해당 그룹이 표시되지 않습니다 — 정상적인 동작입니다. 두 항목의 합계가 해당 동영상의 총 비용입니다.
시간 필드 읽는 방법:
  1. 첫 번째 항목(사전 과금)의 타임스탬프는 동영상의 제출 시간입니다. 해당 항목의 “첫 바이트” 값은 제출 요청이 작업 ID를 반환하는 데 걸린 시간입니다(예: 首字节:3秒 / 첫 바이트: 3초) — 생성 시간이 아닙니다.
  2. 정산 항목에는 流式(스트리밍) 및 首字节:<1秒(첫 바이트 1초 미만)이 표시됩니다 — 이는 정산 레코드의 내부 표시에 불과하며 문제가 발생했다는 의미가 아닙니다.
  3. 동영상의 실제 생성 시간은 상단 탐색 메뉴의 “비동기 작업” 페이지(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 상단의 “비동기 작업”에서 확인할 수 있으며, 과금 내역과 정확히 일치합니다.
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의 공급 역량에 따라 동적으로 조정됩니다. 역량을 갖춘 채널 파트너의 연락을 환영합니다. 이 모델의 가격은 공급을 확보하고 고객에게 서비스를 제공하기 위한 것이며, 수익 창출을 위한 것이 아닙니다.

​
작업 ID로 동영상 하나의 비용 조회: 작업 API 사용

프로그래밍 방식의 대사를 위해 로그 항목을 하나씩 연결하려고 하지 마십시오: 동영상의 두 로그 항목 모두 task_id를 포함하지 않으며, 정산 항목의 request_id는 비어 있습니다(문서화된 /seedance/api/v3/... 경로에서의 작동 방식입니다). 작업 API를 사용하고 로그 조회 API와 동일한 시스템 token으로 인증하여 task_id로 직접 조회하십시오:
반환되는 quota는 동영상의 총비용입니다(선청구 + 정산, ÷ 500,000 = USD). 이는 두 로그 항목을 더해 얻는 값과 같으며, “비동기 작업” 페이지의 작업 상세에 표시되는 동일한 quota입니다. status에 따라 해석하십시오: 두 용어 체계는 다릅니다. 동영상 조회 엔드포인트 /seedance/api/v3/.../tasks/{id}는 성공을 succeeded로 보고하지만, 작업 API /api/task/self는 이를 completed로 보고합니다.
작업 API의 페이지 매김 매개변수는 로그 조회 API와 반대입니다: 여기서는 snake_case page_size를 사용하고 페이지 번호 p는 1부터 시작합니다. 로그 API는 p가 0부터 시작하는 camelCase pageSize를 사용합니다. 잘못 사용해도 오류가 발생하지 않으며, 기본 페이지만 반환됩니다. 검증된 필터: task_id, model_name, start_timestamp / end_timestamp(Unix 초).
로그 조회 API에서 수동으로 교차 확인해야 하는 경우: 정산 항목의 타임스탬프는 작업의 finish_time와 일치하고(1초 이내), 해당 completion_tokens는 작업의 usage.completion_tokens와 같으며, other.final_quota는 작업의 quota와 같고, other.original_quota는 선청구 금액입니다. 여러 작업이 같은 초에 제출되면 선청구 항목이 충돌하므로, 이는 자동 연결이 아닌 수동 확인에만 사용할 수 있습니다. 전체 안내: task_id로 동영상의 실제 비용을 조회하는 방법.

​
그룹 설정

Seedance 2.5 및 2.0 제품군은 전용 그룹에서 실행되며, 두 가지 필수 요구 사항이 있습니다. ① Token의 과금 모델이 종량제 우선(또는 종량제)이어야 합니다. 요청별 과금 token은 라우팅할 수 없습니다. ② Token에 일치하는 그룹이 활성화되어 있어야 합니다. 기본(Default) 그룹 또는 기타 동영상 그룹의 Token은 “no available channel for this model” 오류로 실패합니다. 2.5와 2.0 제품군은 SeeDance2을(를) 공유합니다 — 새 Token에 필요한 유일한 그룹입니다. 단일 모델 그룹인 SD2Mini / SD2Fast 두 개는 이전 한정 기간 할인의 잔재이며, 2026-10-08 12:00 (UTC+8)부터 SeeDance2와(과) 동일하게 0.18x로 복귀했습니다.
SeeDance2 token 하나로 4개 모델 전체에 접근할 수 있습니다: 2.5 및 세 가지 2.0 제품군 모델이 모두 이 그룹에 포함되어 있으므로 코드에서 model 필드만 변경하면 됩니다.SD2Mini / SD2Fast은(는) 단일 모델 채널입니다: SD2Mini은(는) mini만, SD2Fast은(는) fast만 지원하므로, 이를 통해 다른 모델을 호출하면 동일한 오류가 반환됩니다. 이미 이러한 Token을 보유하고 계신 경우 계속 사용하셔도 무방하며, 가격은 SeeDance2와(과) 동일합니다. 하나의 Token으로 모든 모델에 접근하려면 SeeDance2이(가) 활성화된 Token으로 전환하십시오.
2.5 역시 동일하게 0.18x를 사용합니다. 세대 간의 가격 차이는 그룹 요율이 아닌 모델 자체의 단가(Volcengine은 2.5의 가격을 2.0보다 높게 책정함)에서 비롯되므로, 2.5와 2.0 제품군은 정확히 동일한 환산 기준에 따라 실행됩니다.왜 0.18x일까요? 시스템에 내장된 Seedance 단가는 Volcengine의 공식 정가와 일치하지만, 해당 정가는 CNY 기준인 반면 APIYI 잔액은 USD 기준입니다(USD/CNY 1:7 고정 환율). 1x 요율을 적용하면 사실상 공식 금액의 7배가 청구되므로, 통화 환산을 흡수하기 위해 그룹 요율을 낮췄습니다. 0.18이라는 수치는 여기서 비롯된 것이며, 할인도 할증도 아닙니다.Volcengine은 이 시리즈에 대해 할인을 제공하지 않으며, 본 채널은 공급 확보를 위해 가격이 책정되었습니다. 기본적으로 명목 청구 금액은 공식 기준가보다 약간 높게 책정되어 있으나, 충전 보너스를 통해 대부분 상쇄됩니다. 고액 충전 고객은 약 5%만 더 지불하게 되며, 일부 티어(예: 1080p)는 공식 가격보다 낮아집니다.유의 사항: 과금은 항상 실제 token 사용량을 기준으로 이루어지며, token 환산에는 약간의 자연스러운 편차(±5%는 정상 범위)가 발생합니다. 공식 정가는 참고용 기준점일 뿐, 요청별 보장 금액이 아닙니다. 현재 요금 정책은 공급 우선을 고려한 합리적인 구성이므로, 항상 충전 보너스와 함께 종합적으로 평가해 주시기 바랍니다. 청구 금액에 이상이 있는 경우 언제든지 대조 확인을 도와드릴 수 있습니다. 단, “왜 공식 가격보다 약간 비싼가”는 논의 대상이 아니므로 이 점 유의해 주시기 바라며, 이 부분이 우려되신다면 해당 채널 이용을 건너뛰시기 바랍니다. 반면, 대기열 없는 넉넉한 동시 실행 수를 제공한다는 점이 바로 이 채널의 핵심 가치입니다.이에 더해, 에셋 라이브러리(가상 아바타 등록 / 실사인물 인증)가 본 채널에서는 무료로 포함되어 있습니다. 공식적으로는 별도 구매 시 연간 수십만 CNY 규모의 계약이 필요합니다. 이것 또한 본 채널이 제공하는 실질적 가치의 일부입니다.

​
Token 설정 방법

SeeDance2 그룹이 활성화된 Token을 하나 생성하십시오. 이 Token 하나로 4개 모델 전체에 접근할 수 있으며, 코드에서는 model 필드만 변경하면 됩니다. 과금 모델은 종량제 우선(또는 종량제)이어야 합니다. 프로덕션 환경에서는 쿼터를 제한하고 알림을 설정하며 예상치 못한 지출을 추적할 수 있도록 비즈니스 라인당 하나의 Token을 구성하는 것이 좋습니다.
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배 수준으로 실행됩니다. 전체 차이점은 아래 “기술 사양”을 참조하십시오.

​
기술 사양

​
API 엔드포인트

도메인: api.apiyi.com은 기본 게이트웨이이며, b.apiyi.com 및 기타 플랫폼 도메인도 동일하게 동작합니다. 경로 접두사는 /seedance/api/v3입니다 — /api 세그먼트를 생략하지 마십시오.
일반 동영상 엔드포인트를 통해 Seedance 작업을 제출하지 마십시오. /v1/videos, /v1/video/generations 및 /v2/videos/generations은 현재 Seedance resolution 파라미터를 완전히 전달하지 못합니다 — 프로덕션 환경 측정 결과 480p 렌더링에 대한 2.5 요청이 720p로 렌더링되고, 1080p 렌더링에 대한 2.0 패밀리 요청이 720p로 렌더링되었으며, 과금은 실제로 렌더링된 tokens를 기준으로 정산되었습니다(첫 번째 경우 2.25배 추가). 해당 문제는 확인되어 수정 중이며(2026-09-14), 해결되기 전까지는 해상도가 정상 적용되는 이 페이지의 /seedance/api/v3/... 엔드포인트만 사용하십시오. 일반 엔드포인트에서 불일치한 해상도로 과금된 경우, 지원팀에 문의하여 요청한 해상도를 기준으로 차액을 환불받으십시오.

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

해상도 등급은 짧은 변이 아니라 픽셀 영역을 정의합니다. 비율별 실제 출력 크기입니다(공식 값이며, 테스트에서 확인했습니다).
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이 반환되며 과금되지 않습니다.

​
적응형 작동 방식

  1. 텍스트-동영상: 모델이 prompt에서 가장 적합한 비율을 추론합니다.
  2. 첫 프레임+마지막 프레임 / 첫 프레임: 첫 프레임 이미지의 비율과 일치합니다(비율이 일치하지 않는 이미지는 중앙을 기준으로 잘립니다).
  3. 멀티모달 참조-동영상: prompt의 의도를 따르며, 그렇지 않으면 첫 번째 미디어 항목을 따릅니다(이미지보다 동영상이 우선합니다).
  4. 동영상 편집 / 확장(2.5): 출력 비율은 편집하거나 확장하는 입력 동영상에 따라 결정됩니다.
  5. 실제로 사용된 비율은 작업 응답의 ratio 필드에 반환됩니다.
ratio은 위의 7개 enum 값만 허용합니다. 예를 들어 "2:1"을 전달하면 InvalidParameter 오류가 반환되며(확인됨), 지원 범위를 벗어난 duration도 마찬가지입니다(2.5에서는 430, 2.0 제품군에서는 415). 둘 다 과금되지 않습니다.2.5에서는 세 가지 작업 유형에 대해 ratio: adaptive도 강제됩니다: 첫 프레임 / 첫 프레임+마지막 프레임 생성, 동영상 편집, 동영상 확장입니다. 이 경우 구체적인 화면 비율을 전달하면 제출 시점에 InvalidParameter.TaskTypeConstraint이 반환됩니다(측정 결과 동기식 400이며, 몇 분 후 실패하는 작업이 아닙니다).

​
모범 사례

1

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

먼저 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은 중간 선택지입니다.
2

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

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

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

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

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

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

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

generate_audio의 기본값은 true입니다. 직접 음악을 입힐 무음 영상에는 false을 전달합니다.
6

더 나은 보이스오버를 위해 대사를 인용합니다

프롬프트에서 말하는 대사를 큰따옴표로 묶습니다. 그러면 모델이 자동으로 어울리는 음성을 생성합니다.
7

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

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

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

작업은 일반적으로 2~5분 내에 완료됩니다. content.video_url은 24시간 동안 유효한 서명된 링크이므로 작업이 성공하는 즉시 파일을 자체 스토리지로 복사하십시오.
9

return_last_frame으로 클립을 연결합니다

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

​
오류 코드 및 재시도

클라이언트 권장 사항:
  • 생성/폴링 호출에는 30~60초 요청 타임아웃이면 충분합니다(대기는 작업 측에서 처리됩니다).
  • 15~30초마다 폴링하고 전체 허용 시간을 15분 이상으로 설정하십시오(1080p / 15초 작업은 더 길게 설정하십시오).
  • 5xx 및 타임아웃에 지수 백오프를 적용하십시오(2회 재시도).
  • 문제 해결을 위해 작업 id과(와) X-Shellapi-Request-Id 응답 헤더(APIYI 요청 ID이며 로그에서 검색할 수 있고, X-Request-Id은(는) 제공업체 측 ID)를 기록하십시오.

​
자주 묻는 질문 (FAQ)

느린 것은 생성이 아니라 제출 과정입니다. 미디어가 업스트림인 APIYI로 전송된 후 Volcengine으로 전달되어 디코딩 및 유효성 검사를 거쳐야 비로소 작업 ID가 반환됩니다. 인라인 Base64나 대용량 이미지 URL을 사용하면 이 단계가 약 1초에서 수십 초까지 늘어나며, 클라이언트의 60초 읽기 타임아웃으로도 부족할 수 있습니다. 생성 자체는 통상 2~5분이 소요되며, 이는 제공업체의 정상적인 속도로 제출 과정과는 무관합니다.근본적인 해결 방법은 미디어를 먼저 수집(ingest)한 후 asset:// 에셋 ID로 참조하는 것이며, 이를 통해 요청 본문 크기를 메가바이트 단위에서 수십 바이트로 대폭 줄일 수 있습니다. 지연 시간 분석, 마이그레이션 단계 및 타임아웃 발생 후 작업 생성 여부를 확인하는 방법은 에셋 우선 워크플로를 참고하십시오.
필요한 기능에 따라 선택하십시오. 2.5가 무조건적인 기본 선택지는 아닙니다. 2.5는 2.0 표준 모델 대비 약 1.5배의 비용(720p/5초: $1.3721 대 $0.9074)으로 실행되며, 이는 Volcengine 자체 정가 격차와 일치합니다.15초 이상의 클립(2.5는 최대 30초 지원), 9장을 초과하는 참조 이미지(2.5는 최대 30장 지원), mov 출력 또는 제출 시점에 매개변수 오류가 드러나는 동영상 편집/확장(omni_reference_task_type)이 필요한 경우 2.5를 선택하십시오. 또한 2.0은 오디오 외에 이미지나 동영상이 반드시 함께 필요한 반면, 2.5는 오디오만 단독 참조하는 것도 가능합니다.클립 길이가 15초 미만이라면 2.0 제품군을 유지하십시오. 표준 모델도 1080p를 지원하며 동일한 플래그십 품질 티어에 속합니다. 비용에 민감한 대량 제작의 경우 표준 단가의 약 절반 수준이자 가장 빠른 생성 속도를 제공하는 mini을(를) 사용하십시오. 2.0 제품군은 지원이 중단되지 않습니다.엔드포인트, 인증 및 요청 형태는 세대 간에 동일하며 그룹 또한 동일합니다. 즉, 전환 시 model 필드 하나만 변경하면 됩니다.
1080p는 지원됩니다(실측 결과: 1920×1080 정상 렌더링). 4k는 지원되지 않습니다 — "resolution": "4k" 전송 시 동기식 400 오류가 반환됩니다(과금되지 않음).쉽게 놓칠 수 있는 차이점 하나는 2.5가 1080p를 H.265(hvc1)로 인코딩한다는 점입니다. 반면 480p와 720p는 H.264(avc1)를 사용합니다. H.265 파일은 용량이 더 작지만, 구형 플레이어, 일부 브라우저 및 특정 편집 프로그램에서는 H.264보다 호환성이 떨어질 수 있습니다. 1080p 동영상을 배포하기 전에 다운스트림 파이프라인에서 디코딩할 수 있는지 확인하십시오.
두 작업 모두 ‘옴니 참조(omni reference)’ 작업으로, content의 참조 동영상과 prompt에 표현된 의도에 의해 트리거됩니다. 오류가 조기에 드러날 수 있도록 omni_reference_task_type을(를) 명시적으로 전달하십시오:
  • 동영상 편집: omni_reference_task_type: "edit", role: "reference_video" 최소 1개, ratio은(는) adaptive이어야 하고 duration은(는) -1이어야 하며, 원본 동영상 길이는 4~30초여야 합니다. prompt에는 편집 동사(add, remove, delete, change, replace)가 포함되어야 합니다. 출력 비율 및 재생 시간은 입력 동영상을 따르며, 재생 시간은 소수점 단위일 수 있습니다(실측 테스트에서 16.709초 반환).
  • 동영상 확장: omni_reference_task_type: "extend", 역시 참조 동영상이 포함되어야 하며 ratio이(가) adaptive(으)로 설정되어야 합니다. prompt에는 확장 동사(extend, continue)가 포함되어야 합니다.
prompt 내에서는 전달한 순서대로 위치 기반 참조(@video1, @image1)를 사용하십시오. 유효하지 않은 매개변수가 있으면 몇 분 뒤 작업이 실패하는 대신 제출 시 400 오류(InvalidParameter.TaskTypeConstraint)가 반환됩니다.
"output_format": "mov"을(를) 전달하면 색상 및 휘도 충실도가 더 높은 QuickTime 컨테이너(H.264 + yuv444p 크로마 + PCM 오디오)가 반환됩니다. 이는 색보정, 키잉, 합성에 적합하며, 동영상 편집/확장 작업의 입력 및 출력 형식으로 공식 권장됩니다. 기본값은 가장 폭넓은 호환성을 갖춘 mp4입니다.mov는 일부 플레이어에서 열 수 없는 전문가용 코덱을 사용한다는 점에 유의하십시오(macOS의 VLC, mpv, ffplay 및 IINA는 모두 처리 가능합니다). 웹이나 모바일에 바로 배포하려면 기본값인 mp4를 그대로 사용하십시오.
Seedance에서 가장 흔히 발생하는 오류이며, 십중팔구 Token에 잘못된 그룹이 활성화되어 있기 때문입니다. 오류 메시지에는 현재 사용 중인 그룹의 이름이 명시됩니다. 예:
호출할 모델에 맞는 그룹을 확인하고 Token 설정에서 활성화하십시오:SeeDance2이(가) 활성화된 키 하나로 4개 모델을 모두 호출할 수 있습니다(기존 SD2Fast / SD2Mini Tokens 역시 동일한 가격으로 해당 단일 모델을 계속 호출할 수 있습니다). 과금 방식 또한 Pay-as-you-go Priority 또는 Pay-as-you-go여야 합니다 — Pay-per-request Tokens는 라우팅할 수 없습니다.
게이트웨이의 content-encoding: gzip 헤더가 실제 본문 인코딩과 일치하지 않기 때문입니다. 증상으로는 ContentDecodingError, 잘린 비 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입니다. 성공 상태는 completed이(가) 아닌 **succeeded**입니다. 다른 동영상 API에서 마이그레이션할 때 혼동하기 쉬우므로 주의하십시오.
불가능합니다. Seedance 2.5 및 2.0 제품군 모두 실제 사람의 얼굴이 포함된 참조 이미지/동영상을 허용하지 않습니다(업스트림 콘텐츠 보안 정책). 대안: 최근 30일 이내에 Seedance 모델로 생성한 얼굴 포함 결과물을 재사용하거나, 플랫폼의 프리셋 가상 아바타(asset:// ID)를 사용하거나, 라이선스를 취득한 얼굴 에셋을 사용하십시오.
아닙니다. 가상 아바타 수집, 실제 인물 인증 및 기타 프라이빗 에셋 라이브러리는 APIYI의 Seedance 2.0 API에서 연회비 없이 무료로 제공됩니다. 공식적으로 이 기능은 별도 구매해야 하는 애드온으로, 기본 프레임워크 계약이 없는 고객의 경우 연간 6자리 수 CNY(위안화) 규모의 계약이 필요합니다(Volcengine에서도 직접 판매 중). APIYI는 장기 고객을 소중히 여기므로 해당 비용을 이미 API 가격에 반영해 두었습니다. 따라서 일반적인 비즈니스 사용량 범위 내에서 SD2 API를 정상적으로 사용하는 고객에게는 추가 요금이 청구되지 않습니다. 사용법은 에셋 라이브러리를 참고하십시오.
매개변수 오류로 인한 거부(HTTP 400)는 과금되지 않습니다(검증 완료). 과금은 제출 시 사전 청구된 후 완료 시 정산되므로 잔액이 일시적으로 변동할 수 있습니다. 호출 로그를 통해 대조 확인하십시오.
tokens ≈ duration(s) × width × height × 24 / 1024, 0.1% 오차 범위 내에서 검증되었습니다. 동일 티어 내의 모든 화면 비율은 픽셀 면적이 동일하므로(720p 16:9와 9:16 모두 5초당 108,900 tokens) — 가로, 세로, 정사각형 모두 비용이 동일합니다.
가격과 속도는 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 표준 모델로도 충분하며, 1080p만을 위해 업그레이드할 필요는 없습니다. 30초 클립, 9장을 초과하는 참조 이미지, mov 출력 또는 동영상 편집/확장이 필요한 경우 2.5를 이용하십시오(표준 모델 가격의 약 1.5배, 2.0 제품군과 동일한 그룹).
모델이 길이를 직접 결정하며(2.5는 430초, 2.0 제품군은 415초), 실제 출력 길이에 따라 과금됩니다. 최종 길이는 작업의 duration 필드에 반환됩니다.2.5에서는 -1이(가) 기본값이라는 점에 유의하십시오(2.0 제품군의 기본값은 5초입니다). 따라서 duration을(를) 생략하면 모델이 길이를 결정하게 되며, 실측 테스트에서 duration 없이 전송된 2.5 요청은 5초 비용의 정확히 2배인 10초 클립을 반환했습니다. 비용 예측 가능성이 중요하다면 duration을(를) 명시적으로 전달하십시오.
지원되지 않습니다. frames 및 camera_fixed은(는) Seedance 1.x 매개변수로, Seedance 2.5 및 2.0 시리즈 모두에서 지원되지 않습니다. 대신 정수 초 단위의 duration을(를) 사용하십시오.
불가능합니다. 이 세 가지는 서로 상호 배타적인 모드입니다: 시작+끝 프레임(first_frame/last_frame 역할이 필수인 이미지 2장), 시작 프레임(이미지 1장), 멀티모달 참조-비디오 생성(이미지 역할 reference_image). ‘시작/끝 프레임 + 참조 이미지’와 유사하게 구현하려면 참조 모드를 사용하고 prompt를 통해 프레임을 지정하십시오.참조 제한은 세대별로 다릅니다. 2.5는 이미지 30장 + 동영상 10개 + 오디오 클립 10개를 지원하며 오디오 단독 사용이 가능합니다. 반면 2.0 제품군은 이미지 9장 + 동영상 3개 + 오디오 클립 3개를 지원하며 오디오 사용 시 최소 1개의 이미지 또는 1개의 동영상이 반드시 함께 제공되어야 합니다.
SeeDance2 그룹은 동시 실행 수가 충분하여 대기열이 없습니다(테스트 시 15개의 동시 작업이 모두 즉시 실행됨). 지속적으로 대규모 워크로드가 필요한 경우 영업팀에 문의하십시오.
prompt는 중국어 약 500자 또는 영어 약 1,000단어 이내로 유지하십시오. prompt가 너무 길어지면 세부 묘사가 약화됩니다. 지원 언어: 중국어, 영어, 일본어, 스페인어, 포르투갈어, 인도네시아어. 피사체 + 동작 + 카메라 움직임 + 조명/스타일 순으로 설명하는 것을 권장합니다.

​
관련 문서

Seedance는 기본적으로 동기화된 오디오를 출력하는 2026년형 1티어 동영상 모델 제품군 중 하나입니다. 동일한 가격의 화면비와 2.5의 30초 제한이 결합되어, 숏폼 동영상 및 이커머스 에셋 제작을 위한 강력한 주요 채널입니다. 대안을 비교하려는 경우, 동일한 토큰으로(추가 그룹을 활성화하여) Sora 2, VEO 3.1, Wan2.7을 직접 호출할 수 있습니다.