Seedance 2.5 이용 방법 | 키, 요청, 첫 렌더

ByteDance는 2026년 7월 31일에 Seedance 2.5를 발표했고, 호스트들은 그 뒤 제각각의 시점에 이를 받아들였습니다. 그 시차 있는 롤아웃 때문에 Seedance 2.5 이용 방법은 보기보다 까다로운 질문이 됩니다. 적지 않은 창구가 2.5를 광고하면서 속으로는 여전히 옛 모델을 돌리고 있기 때문입니다. 첫 렌더에 도달한다는 것은 버전을 확인하고, 키를 쥐고, 기본값을 실제로 읽어 본 요청을 보낸다는 뜻입니다.

먼저, 버전이 진짜인지 확인합니다

두 가지 확인이면 끝나고, 어느 쪽도 비용이 들지 않습니다.

20초를 요청해 보십시오. Seedance 2.5는 한 번의 생성에서 4초부터 30초까지 갑니다. Seedance 2.0은 15초에서 멈춥니다. 20초 요청이 길이 필드에서 거부되면 2.0 위에 있는 것입니다. 검증 거부는 작업이 생성되기 전에 일어나므로 아무것도 과금되지 않습니다.

모델 식별자를 읽으십시오. 출시된 2.5 빌드는 -face로 끝나는 문자열로 제공되며, 전체를 쓰면 doubao-seedance-2.5-face입니다. 출시 이전에 공개된 코드 샘플은 그 접미사가 없는 식별자를 인용하는데, 이제는 해석되지 않습니다. 어떤 플랫폼의 문서가 여전히 옛 문자열을 보여 준다면, 그 통합은 출시보다 앞선 것입니다.

결정적이지는 않지만 시사하는 바가 있는 세 번째 확인이 있습니다. 인터페이스가 4K 등급을 제공한다면 그것은 출시 전 마케팅을 설명하고 있는 것입니다. 이 모델은 모든 호스트에서 1080p가 최대이고 그 아래에 720p와 480p가 있습니다.

키와 파일을 둘 곳을 마련합니다

플랫폼 대시보드에서 받은 API 키를 Authorization: Bearer 헤더로 보내는 것이 인증의 전부입니다. 지출 자격 증명으로 취급하고 서버에 두십시오.

레퍼런스 소재를 쓸 생각이라면 그것을 올려 둘 곳도 필요합니다. 미디어 입력은 공개 HTTP 또는 HTTPS URL만 받습니다. 데이터 URI는 플랫폼 전역에서 거부되므로, 로컬 파일은 참조되기 전에 업로드되어야 합니다.

첫 요청으로 Seedance 2.5 이용하기

호출은 플랫폼의 영상 생성 엔드포인트로 보내는 POST입니다. 영상이 아니라 작업 id를 반환합니다. 그다음 상태가 종료 상태가 될 때까지 작업 엔드포인트를 폴링합니다. 폴링은 무료입니다.

쓸 만한 최소 본문은 모델 문자열, 프롬프트, 길이입니다. 그 아래 깔린 기본값이 대부분의 사람이 예상하는 것보다 중요합니다:

필드	기본값	알아 둘 점
길이	5초	범위는 4~30초. -1로 두면 모델이 고르고 30초 상한에서 선점합니다
해상도	720p	나머지 두 선택지는 480p와 1080p입니다
화면비	adaptive	출력에 목표 프레임이 있다면 고정 비율을 쓸 수 있습니다
오디오	켜짐	대사, 효과음, 음악이 화면과 함께 생성됩니다

기본 길이 5초는 첫 렌더로 합리적입니다. 초반에 피해야 할 값은 -1입니다. 예약이 모델이 결국 만들어 낼 길이가 아니라 천장에서 잡히기 때문입니다.

프롬프트는 20000자까지 들어갑니다. 텍스트로 영상을 만들 때는 프롬프트가 필수이고, 레퍼런스 미디어가 붙는 순간 선택 사항이 됩니다.

레퍼런스 미디어라는 문

이것이 2.5를 옛 버전과 갈라놓는 능력이고, 첫 요청에서 바로 손이 닿습니다. 작업 하나가 레퍼런스 이미지 최대 30장, 레퍼런스 영상 클립 10개, 오디오 트랙 10개를 받습니다.

체화해 둘 것은 과금의 비대칭입니다. 레퍼런스 이미지와 레퍼런스 오디오는 청구서에 아무것도 더하지 않습니다. 레퍼런스 영상은 더하고, 그것도 두 번에 걸쳐 더합니다. 소스 클립은 출력과 별개로 자기 길이만큼 과금되고, 영상이 포함된 요청은 출력 길이의 3분의 5라는 과금 하한을 짊어집니다. 2초 소스에 5초 출력이면 7초가 아니라 9초가 청구됩니다. 레퍼런스 클립 하나는 2~30초이고 합산 레퍼런스 영상은 30초를 넘길 수 없습니다.

그래서 정지 이미지로 조건화한 첫 렌더는 놀랄 일이 거의 없습니다. 영상으로 조건화한 첫 렌더는 그렇지 않으니 작게 가야 합니다.

첫 클립의 비용

요금은 완성 영상의 초 단위이고, 해상도와 요청에 레퍼런스 클립이 실렸는지에 따라 정해집니다:

해상도	생성만	레퍼런스 영상 포함
480p	$0.118589	$0.071153
720p	$0.266824	$0.160094
1080p	$0.461856	$0.275904

480p 5초 클립은 약 $0.59입니다. 1080p 10초 클립은 약 $4.62입니다. 이 두 숫자 사이의 거리가 첫 시도를 짧고 작게 해야 한다는 논거입니다. 프롬프트가 의도한 대로 작동하는지 확인하고, 그다음에야 해상도와 길이를 올리십시오.

생성은 2~5분이 걸립니다. 실패한 작업은 거부를 포함해 전액 환불됩니다.

첫 호출이 실패할 때

안전 거부는 80006 오류를 반환합니다. 어느 단계에서 걸렸는지 알려 주지 않으므로 프롬프트, 레퍼런스 이미지, 생성된 출력이 모두 후보이고, 진단은 수동입니다. 중립적인 프롬프트로 줄여 통과하는지 확인한 뒤, 요소를 하나씩 되돌려 넣으십시오.

content_filter 파라미터는 기본값이 true입니다. false로 설정하면 요청이 덜 제한적인 채널로 라우팅될 뿐 검열이 꺼지지는 않습니다. 그 아래에는 실명이 거론된 실존 유명인, 제3자 지식재산, 불법 콘텐츠에 대한 모델 수준의 차단이 깔려 있고, 이는 어떤 호스트 설정으로도 사라지지 않습니다.

첫 호출 실패 목록의 나머지는 전부 검증입니다. 4~30초를 벗어난 길이, 폐기된 모델 문자열, data: URL, 길이 제한을 넘은 레퍼런스 클립. 어느 것도 작업을 만들지 않으므로 어느 것도 비용이 들지 않습니다.

자주 묻는 질문

2.0 대신 Seedance 2.5를 쓰려면 다른 계정이 필요합니까? 아닙니다. 둘 다 제공하는 플랫폼은 하나의 계정, 하나의 키에서 별도의 모델 식별자로 노출합니다. 버전 사이를 오가는 것은 대개 문자열 하나를 바꾸는 일입니다.

어떤 플랫폼이 정말 2.5를 돌리고 있는지 어떻게 압니까? 20초를 요청하십시오. 성공하면 2.5, 길이 필드에서 거부되면 2.0입니다. 그다음 모델 식별자가 -face로 끝나는지 확인하십시오.

API 키 없이 Seedance 2.5를 이용할 수 있습니까? 소비자용 앱과 편집기 번들 통합은 키 없이 모델에 닿지만, 파라미터 접근과 초당 과금을 잃습니다. 대신 프리셋과 크레딧 잔액을 받습니다.

어떤 요금제에서든 4K가 제공됩니까? 아닙니다. 출시된 모델은 1080p가 상한입니다. 4K라는 수치는 끝내 제공되지 않은 출시 전 보도에서 나온 것입니다.

한 줄 요약

Seedance 2.5 이용 방법은 네 단계입니다. 20초 요청과 -face 식별자로 버전을 검증하십시오. 키를 받아 서버 쪽에 두십시오. 길이와 해상도만 손대고 나머지 기본값은 그대로 둔 채, 480p 5초짜리 짧은 첫 작업을 보내십시오. 2~5분 폴링하고 결과를 내려받으십시오. 레퍼런스 이미지와 오디오는 붙여도 무료이고, 레퍼런스 영상은 자기 길이만큼 3분의 5 하한과 함께 과금되며, 실패한 것은 무엇이든 환불됩니다.