seedance-2
seedance-2 비디오 생성
Generate videos with seedance-2, seedance-2-fast, and seedance-2-mini
POST
- Supports
seedance-2,seedance-2-fast, andseedance-2-mini - Supports text-to-video, first-frame / first-last-frame image-to-video, and multimodal reference-to-video;
seedance-2-minialso supports frame roles and the audio generation switch - Supports combined image, video, and audio references;
seedance-2-miniallows up to9images,3videos, and3audios - Async task workflow: the submit API returns
generation.task, and the completed result is fetched from the task status API
Authorizations
string
필수
Body
string
기본값:"seedance-2"
필수
Video generation model name.Available models:
seedance-2- Standard version for higher quality output and the broader Seedance 2 workflowseedance-2-fast- Faster version for previews and lower-latency iterationseedance-2-mini- Lightweight version for lower-cost drafts and multimodal reference workflows, currently fixed to1result per request
string
Video prompt.We recommend clearly describing the scene, camera motion, subject action, style, and audio mood.
string
Your business-side ID, such as an order number or internal job ID. Once submitted, it is stored with the task and can be used later for status lookup:
GET /v1/videos/generations/{client_business_id}.metadata.client_business_id is also accepted, but the top-level field is recommended.integer
기본값:0
Video duration in seconds.Rules:
seedance-2:4-15seedance-2-fast:4-15seedance-2-mini:4-150: auto duration (seedance-2/seedance-2-fastonly)-1: auto duration (seedance-2/seedance-2-fastonly)
string
Video aspect ratio.Options:
21:916:94:31:13:49:16adaptive
adaptive lets the upstream choose an appropriate ratio from the input media.string[]
Compatibility image URL array.We recommend using
image_with_roles instead so you can explicitly mark first_frame, last_frame, or reference_image.array
Image list with explicit roles.Supported patterns:
seedance-2/seedance-2-fast/seedance-2-minifirst_framefor first-frame image-to-videofirst_frame+last_framefor first-last-frame video generationreference_imagefor multimodal reference generation
array
Video list with roles.Only
reference_video is currently supported in multimodal reference mode.Limits:seedance-2-mini: up to3reference videos
array
Audio list with roles.Only
reference_audio is currently supported in multimodal reference mode.Limits:seedance-2-mini: up to3reference audios
string
기본값:"720p"
Video resolution.Options:
seedance-2:480p,720p,1080p,4kseedance-2-fast:480p,720pseedance-2-mini:480p,720p
boolean
기본값:true
Whether to generate synced audio.
seedance-2-mini also supports this field.boolean
기본값:false
생성된 동영상의 마지막 프레임 이미지를 반환할지 여부입니다.
true로 설정하면 완료된 작업 응답의 result.data[0].last_frame_url에서 이미지 URL을 확인할 수 있습니다.array
모델이 호출할 수 있는 도구입니다. Seedance 2 시리즈는 현재 웹 검색을 지원합니다.실제 검색 횟수는
usage.tool_usage.web_search에 반환되며, 0은 검색을 실행하지 않았음을 의미합니다.integer
Random seed for generation control.
string
호출자 추적 필드이며 Webhook 설정과 무관합니다.
Use Uploaded Assets
If you already uploaded private assets and obtained a usableasset_id, you do not need to send the original media URL again. Use:
asset://<ASSET_ID>
- Images:
first_frame,last_frame,reference_image - Videos:
reference_video - Audios:
reference_audio
active status.
Related guides:
Input Combinations
Typical supported combinations:- Text only: text-to-video
- Text + first frame: first-frame image-to-video
- Text + first frame + last frame: first-last-frame generation
- Text + reference images: multimodal reference generation
- Text + reference video: video-reference generation
- Text + reference images + reference audio: multimodal reference generation
- Text + reference images + reference video + reference audio: multimodal reference generation
Capabilities
seedance-2-mini is currently fixed to 1 output per request and does not expose count / n. Express frame control through image_with_roles using first_frame / last_frame.응답
string
Task ID for status queries.
string
Your business-side ID. Returned only when
client_business_id was provided in the request.string
Object type, always
generation.task.string
모델 name used for this request.
string
Task status:
queued, in_progress, completed, or failed.integer
Task progress percentage (
0-100).integer
Task creation timestamp.
The submit API returns the base task object. After completion, use Get Video Task 상태 to fetch
completed_at, expires_at, and result.type = "video" with result.data[].url and result.data[].format. return_last_frame을 사용하면 result.data[0].last_frame_url, web_search를 사용하면 usage.tool_usage.web_search도 반환됩니다.