영상 생성 모델 ID입니다. Seedance 2.5 Flash의 모델 ID는 doubao-seedance-2-5-flash-261115이며 해당 Endpoint ID도 사용할 수 있습니다.
content*array<|||||>
텍스트, 이미지, 영상 또는 오디오를 입력합니다. 참조 소재는 이미지 10장, 영상 5개, 오디오 5개까지 사용할 수 있습니다. 영상과 오디오의 개별 길이는 230초이고 각 종류의 총 길이는 30초를 넘을 수 없습니다. 영상 편집용 참조 영상은 430초여야 합니다. 오디오만 참조할 수도 있습니다.
첫 프레임만 사용하면 이미지 하나로 role을 생략하거나 first_frame을 지정합니다. 첫/마지막 프레임은 이미지 두 개에 first_frame, last_frame을 명시합니다. 참조 소재는 해당 reference_* 역할이 필요합니다. 모드를 혼용할 수 없고 마지막 프레임의 비율이 다르면 첫 프레임에 맞게 자릅니다.
이미지/오디오는 공개 URL, Base64 data URI, asset://ASSET_ID를, 비디오는 공개 URL 또는 소재 ID를 지원합니다. 본문은 최대 64 MB이며 큰 파일에는 URL을 권장합니다. 프롬프트에서 @image1, @video1, @audio1로 소재를 참조할 수 있습니다.
항목1 <= items
draft?false
Draft 모드를 지원하지 않습니다. 이 필드를 생략하거나 false로 설정하고 true는 전달하지 마세요.
기본값false
허용 값
false
omni_reference_task_type?string
멀티모달 참조 작업 유형입니다. auto는 자동 판단, reference는 참조 생성입니다. edit는 참조 영상과 ratio=adaptive, duration=-1이 필요하고 extend는 참조 영상과 ratio=adaptive가 필요합니다. 유형을 명시하면 사전 검증하지만 실제 판단과 지정 유형이 다르면 비동기로 실패할 수 있습니다.
기본값"auto"
허용 값
"auto"
"reference"
"edit"
"extend"
generate_audio?boolean
화면과 동기화된 소리를 생성할지 지정합니다. true는 프롬프트와 영상에 맞는 음성, 효과음, 배경 음악을 생성하고 false는 무음 영상을 생성합니다. 출력 오디오는 입력 오디오의 채널 수와 관계없이 스테레오입니다.
기본값true
ratio?string
비디오 화면 비율입니다. 텍스트 기반 및 멀티모달 참조 기반 생성에서는 비율을 지정하거나 adaptive를 사용할 수 있습니다. 시작 프레임, 시작·종료 프레임, 비디오 편집 및 연장 작업은 adaptive만 지원합니다.
기본값"adaptive"
허용 값
"16:9"
"4:3"
"1:1"
"3:4"
"9:16"
"21:9"
"adaptive"
duration?|integer
생성 길이이며 단위는 초입니다. 4–30을 지원하며 -1을 전달하면 모델이 자동으로 결정합니다. 비디오 편집은 -1만 지원하고 비디오 연장은 4–30 또는 -1을 지원합니다.
기본값-1
resolution?string
출력 영상의 해상도입니다. 480p와 720p를 지원합니다. 실제 픽셀 크기는 해상도와 화면 비율에 따라 결정됩니다.
기본값"720p"
허용 값
"480p"
"720p"
output_format?string
출력 비디오 형식입니다. mp4는 웹과 일반 배포에 적합합니다. mov는 H.264, YUV444P 및 PCM을 사용하며 색 보정, 배경 제거, 합성 등 후반 작업에 적합합니다.
기본값"mp4"
허용 값
"mp4"
"mov"
watermark?boolean
오른쪽 아래 ‘AI 생성’ 워터마크: true는 추가, false는 제외합니다.
기본값false
seed?integer
난수 시드이며 범위는 -1–4294967295입니다. 같은 시드는 결과 재현성을 높일 수 있지만 완전히 동일한 결과를 보장하지는 않습니다.
범위-1 <= value <= 4294967295
return_last_frame?boolean
true이면 content.last_frame_url에서 비디오와 같은 크기의 워터마크 없는 JPEG를 얻어 연속 생성에 사용할 수 있습니다. false이면 마지막 프레임을 반환하지 않습니다.
기본값false
callback_url?string
상태 변경 시 POST 알림을 받을 URL. 본문은 네이티브 작업 조회 응답과 같습니다. 미설정 시 조회 API를 폴링합니다.
알림 상태는 queued, running, succeeded, failed, expired입니다. 성공/실패 알림은 5초 안에 수신 성공 확인이 없으면 세 번 재시도합니다.
형식uri
safety_identifier?string
영문 문자열로 된 최종 사용자 식별자입니다. 같은 사용자에게 고정되고 고유해야 하며 최대 64자입니다. 개인 정보 대신 사용자 이름, ID 또는 이메일의 해시값을 전달하는 것을 권장합니다.
길이1 <= length <= 64
execution_expires_after?integer
생성 시점부터 계산한 작업 유효 시간이며 단위는 초입니다. 이 시간이 지난 후에도 완료되지 않은 작업은 만료 상태가 됩니다.
형식int32
범위3600 <= value <= 259200
기본값172800
tools?array<>
온라인 검색을 설정합니다. 모델이 프롬프트에 따라 판단하므로 최신성은 높아지고 지연은 늘 수 있습니다. 횟수는 usage.tool_usage.web_search에 있으며 0은 미실행입니다.
service_tier?string
서비스 등급입니다. Seedance 2.5 Flash는 default 온라인 추론만 지원하며 flex는 지원하지 않습니다. 대기열 우선순위는 priority로 설정합니다.
기본값"default"
priority?integer
동일한 추론 엔드포인트 내 대기열 우선순위로 0~9입니다. 값이 클수록 우선하며 같은 우선순위는 제출 순서대로 처리됩니다. 실행 중인 작업은 중단하지 않습니다.