Skip to main content
POST
  • Supports seedance-2, seedance-2-fast, and seedance-2-mini
  • Supports text-to-video, first-frame / first-last-frame image-to-video, and multimodal reference-to-video; seedance-2-mini also supports frame roles and the audio generation switch
  • Supports combined image, video, and audio references; seedance-2-mini allows up to 9 images, 3 videos, and 3 audios
  • Async task workflow: the submit API returns generation.task, and the completed result is fetched from the task status API

Authorizations

string
필수
All requests require Bearer Token authentication.Get your API Key from the API Key Management Page.

Body

string
기본값:"seedance-2"
필수
Video generation model name.Available models:
  • seedance-2 - Standard version for higher quality output and the broader Seedance 2 workflow
  • seedance-2-fast - Faster version for previews and lower-latency iteration
  • seedance-2-mini - Lightweight version for lower-cost drafts and multimodal reference workflows, currently fixed to 1 result 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-15
  • seedance-2-fast: 4-15
  • seedance-2-mini: 4-15
  • 0: auto duration (seedance-2 / seedance-2-fast only)
  • -1: auto duration (seedance-2 / seedance-2-fast only)
string
Video aspect ratio.Options:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • adaptive
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.
  • Do not use image_urls together with image_with_roles.
  • For new integrations, use image_with_roles to explicitly mark how each image should be used.
array
Image list with explicit roles.Supported patterns:
  • seedance-2 / seedance-2-fast / seedance-2-mini
    • first_frame for first-frame image-to-video
    • first_frame + last_frame for first-last-frame video generation
    • reference_image for multimodal reference generation
  • Maximum 1 first_frame
  • Maximum 1 last_frame
  • Maximum 9 reference_image
  • Frame mode and reference mode cannot be mixed
  • seedance-2-mini also supports first_frame, last_frame, and reference_image
array
Video list with roles.Only reference_video is currently supported in multimodal reference mode.Limits:
  • seedance-2-mini: up to 3 reference videos
array
Audio list with roles.Only reference_audio is currently supported in multimodal reference mode.Limits:
  • seedance-2-mini: up to 3 reference audios
audio_with_roles cannot be used alone. At least one visual input is required.
string
기본값:"720p"
Video resolution.Options:
  • seedance-2: 480p, 720p, 1080p, 4k
  • seedance-2-fast: 480p, 720p
  • seedance-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은 검색을 실행하지 않았음을 의미합니다.
tools는 텍스트-투-비디오 요청에서만 지원되며 이미지, 동영상 또는 오디오 입력과 함께 사용할 수 없습니다.
integer
Random seed for generation control.
string
ToAPIs 표준 완료 callback입니다. Token URL과 secret을 먼저 설정하며 같은 origin만 덮어쓸 수 있습니다. Webhook.
string
호출자 추적 필드이며 Webhook 설정과 무관합니다.

Use Uploaded Assets

If you already uploaded private assets and obtained a usable asset_id, you do not need to send the original media URL again. Use:
  • asset://<ASSET_ID>
Asset inputs can be used as:
  • Images: first_frame, last_frame, reference_image
  • Videos: reference_video
  • Audios: reference_audio
Before use, make sure the asset has reached 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
seedance-2-mini also supports first-frame and first-last-frame workflows. Use image_with_roles with explicit first_frame / last_frame roles.

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도 반환됩니다.