메인 콘텐츠로 건너뛰기

소개

Seedance 공식 미러 비동기 비디오 생성 작업을 제출합니다. 성공 시 작업 id를 반환합니다. content와 prompt 중 최소 하나를 제공해야 합니다. BytePlus Ark 공식 인터페이스와 요청 본문 및 응답 본문이 완전히 동일합니다.

요청 주소

POST

인증

string
필수
Bearer Token, 예: Bearer sk-your_token_key
string
application/json

요청 매개변수

string
필수
모델 ID: seedance-2-0 / seedance-2-5 / seedance-2-0-mini / seedance-2-0-fast
array
콘텐츠 배열: text / image_url / video_url / audio_url, 각 요소에 role 지정 가능 (first_frame / last_frame / reference_image / reference_video / reference_audio); prompt와 중 최소 하나 필수
string
간소화 작성 방식, content와 택일
string
작업 상태 변경 시 콜백 주소
boolean
기본값:"false"
마지막 프레임 이미지 반환 여부
string
기본값:"default"
default / flex
integer
기본값:"172800"
작업 만료 시간(초), 범위 [3600, 259200]
boolean
기본값:"true"
오디오 생성 여부
string
최종 사용자 고유 식별자(사용자 ID 해시 전달 권장)
string
기본값:"720p"
480p / 720p / 1080p / 4K (seedance-2-0-fast와 seedance-2-0-mini는 480p/720p만 지원)
string
기본값:"adaptive"
16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive
integer
기본값:"5"
초 단위, [4,15] 또는 -1(자동)
string
기본값:"auto"
seedance2.5에서만 지원되며, 다른 모델에서는 무시됩니다:
  • auto: 자동 추론
  • reference: 참조 기반 비디오 생성, 특별한 제약 없음
  • edit: 비디오 편집, ratio=adaptive와 duration=-1 필수, content에 4~30초 길이의 참조 비디오가 정확히 1개 포함되어야 함
  • extend: 비디오 연장, ratio=adaptive 필수, content에 참조 비디오가 포함되어야 함
제출 시점에 ratio/duration/content가 해당 타입과 일치하는지 사전 검증하는 용도일 뿐, 모델이 prompt로부터 추론하는 실제 작업 타입을 강제로 덮어쓰지 않습니다. 제약 조건이 충족되지 않으면 InvalidParameter.TaskTypeConstraint를 반환합니다.
integer
기본값:"-1"
랜덤 시드
boolean
기본값:"false"
워터마크 추가 여부
content[].image_url.url / video_url.url / audio_url.url은 세 가지 값을 지원합니다: 공개 URL, Base64 (data:image/png;base64,...), asset://<ASSET_ID> 자산 라이브러리 참조.

요청 예제

응답 예제

다음 단계: 비디오 생성 작업 조회