Seedance 2.5 API가 제공하는 것
POST 한 번으로 작업을 만들고 GET 한 번으로 상태를 확인하며, 폴링은 무료입니다. Seedance 2.5 API는 별도 파라미터가 아니라 어떤 미디어 필드를 채웠는지로 모드를 판단합니다.
prompt만 있으면 텍스트 기반 생성입니다. 이미지를 더하면 Seedance 2.5 API가 이미지 기반 생성을 수행합니다. 첫 프레임과 마지막 프레임을 더하면 그 사이 전환을 만들고, 소스 클립을 더하면 편집하거나 이어 붙입니다.
POST는 즉시 작업 id를 반환하고 생성에는 2~5분이 걸립니다. Seedance 2.5 API 연동에는 동기 요청이 아니라 폴링 루프나 큐가 필요합니다.
플랫폼은 doubao-seedance-2.5-face로 제공합니다. Seedance 2.5 API 모델 문자열을 잘못 적는 것이 첫 호출에서 가장 흔한 실패 원인이며, 요금 부과 없이 동기 오류가 돌아옵니다.
헤더 하나, 워크스페이스 단위, 프로젝트 id 없음입니다. Seedance 2.5 API 키는 발급한 워크스페이스의 과금 범위를 그대로 따릅니다.
심사 거부를 포함해 실패한 모든 작업은 크레딧이 전액 반환됩니다. Seedance 2.5 API는 받지 못한 렌더링에 요금을 부과하지 않습니다.
이 페이지에는 생성기가 없습니다. Seedance 2.5 API 호출은 호스팅 API에서 실행되며, 아래의 모든 파라미터와 요금은 공식 문서에서 가져왔습니다.
가장 중요한 Seedance 2.5 API 파라미터
비용과 결과를 결정하는 네 가지 필드입니다.
duration
4초에서 30초까지이며 기본값은 5초입니다. -1을 넘기면 모델이 알아서 정하지만, Seedance 2.5 API는 30초 상한 기준으로 크레딧을 선점한 뒤 차액을 환불하므로 잔액이 빠듯하면 402가 발생할 수 있습니다.
resolution
480p, 720p, 1080p이며 기본값은 720p입니다. Seedance 2.5 API에 4K는 없으며, 요청하면 해상도를 낮춘 클립이 아니라 오류가 돌아옵니다.
content_filter
불리언이며 기본값은 true입니다. false로 두면 Seedance 2.5 API 요청이 제한이 덜한 채널로 라우팅되고 prompt가 필수가 됩니다. 플랫폼은 이를 차단 해제 스위치가 아니라 라우팅으로 문서화하고 있습니다.
omni_reference_task_type
편집 또는 확장으로 선언해 두면 Seedance 2.5 API가 몇 분 뒤에 실패하는 대신 제출 시점에 규칙을 검증합니다. 레퍼런스를 쓰는 작업이라면 설정해 둘 만합니다.
작동하는 Seedance 2.5 API 호출까지 4단계
- 1
키 발급
플랫폼 대시보드에서 키를 발급해 bearer token으로 전송하십시오. Seedance 2.5 API는 authorization 헤더에서 그 외의 방식을 거부합니다.
- 2
작업 POST
모델, prompt, 그리고 필요한 미디어 URL을 영상 생성 엔드포인트로 보내십시오. Seedance 2.5 API의 모든 미디어 필드는 공개 HTTP 또는 HTTPS URL을 받으며, base64는 플랫폼 전체에서 거부됩니다.
- 3
작업 폴링
상태가 완료 또는 실패가 될 때까지 작업 id를 GET하십시오. Seedance 2.5 API 폴링에는 비용이 들지 않으므로 2초 간격이면 충분합니다.
- 4
결과 읽기
완료된 Seedance 2.5 API 작업에는 영상 URL이 들어 있고, 요청했다면 마지막 프레임 URL도 함께 옵니다. 전달된 URL은 영구적이지 않으므로 보관할 파일은 직접 다시 호스팅하십시오.
Seedance 2.5 API에 대한 답변
과금 대상 영상 1초 단위로, 해상도와 요청에 레퍼런스 클립이 포함됐는지에 따라 $0.071153에서 $0.461856까지입니다. 10초 1080p 렌더링은 약 $4.62입니다. 레퍼런스 이미지와 레퍼런스 오디오는 요금에 더해지지 않습니다.
출력 길이에 레퍼런스 영상의 전체 길이를 더하며, 영상이 포함된 요청은 출력 길이의 3분의 5를 최소 기준으로 잡습니다. 2초짜리 소스에 5초 출력이면 7초가 아니라 9초로 청구되며, 대부분의 첫 연동에서 이 부분을 예상하지 못합니다.
호스팅 API에서는 doubao-seedance-2.5-face입니다. 오래된 가이드는 접미사 없는 doubao-seedance-2.5를 인용하는데, 이는 출시 이전 표기이며 실제로 해석되지 않습니다. 코드 예제를 믿기보다 모델 페이지를 확인하십시오.
문서에 명시된 방식은 폴링이며 무료이므로, 짧은 간격의 반복 조회가 가장 단순한 Seedance 2.5 API 연동입니다. 생성에 2~5분이 걸리는 만큼 2~5초 간격 폴링은 부하라고 할 것도 없고 콜백 인프라도 필요 없습니다.
스키마 검증이며 요금은 부과되지 않았습니다. 흔한 원인은 잘못된 해상도 값, 첫 프레임이나 마지막 프레임과 함께 지정한 크기 값, 또는 텍스트 기반 요청에서의 prompt 누락입니다. 오류 메시지가 문제가 된 필드를 알려 줍니다.
작업 유형 규칙이거나 심사입니다. error 80006은 안전 정책에 의한 거부이며 단계를 밝히지 않습니다. 편집 작업에서의 파라미터 불일치는 다른 형태로 실패하며, omni_reference_task_type을 명시해 두면 다음부터는 그 문제가 즉시 400으로 돌아옵니다.
이미지 최대 30장, 합계 30초인 영상 클립 10개, 오디오 트랙 10개까지입니다. 이미지 배열과 역할 태그가 붙은 이미지 배열은 함께 쓸 수 없으므로, Seedance 2.5 API 요청마다 하나만 고르십시오.
있습니다. 같은 엔드포인트에 모델 id만 다르게 넣으면 됩니다. Seedance 2.0은 15초에서 잘리고 2.5는 30초까지 가며, 요청 형태가 거의 같아서 버전 전환은 대체로 문자열 하나 바꾸는 일입니다.
키는 발급한 워크스페이스의 과금 범위를 그대로 따르며 별도의 프로젝트 헤더는 없습니다. 사용량이 워크스페이스 단위로 합산되므로, 회계를 분리해야 하는 팀은 한 워크스페이스 안에서 키를 나누는 대신 워크스페이스 자체를 나눕니다.