ナビゲーションにスキップ

Seedance 2 Fast

Generate 4–15 second 480p or 720p videos through the official faster Seedance 2.0 route, with optional generated audio.

Supported modes

ModeRequired inputRules
Text to videomodel, promptOmit all media arrays.
First framemodel, prompt, imagesProvide one image URL; provide two for first and last frames.
Multimodal referencesmodel, prompt, one reference_* arrayAudio references also require a reference image or video.

Page estimate: The selected resolution and aspect ratio determine an estimated delivery pixel area A. With requested output seconds D and total reference-video seconds R, the page estimates video tokens as N = A * (24 * D + 1 + 24 * R) / 1024. Multiply N by the current video-token rate; a request with video references uses a separate rate. Without a reference video, R is 0. With references, use their known total length; when the page does not know it, its estimate uses 15 seconds, the documented maximum total reference-video length. reference_video_seconds is an internal estimator input, not a public request field; do not send it in the API body.

Estimate and task usage: Compare the complete configuration, including reference inputs. These page-estimate rules do not establish a fixed billing multiplier, the production reservation rule or a refund entitlement. Record returned usage.credits_reserved, usage.credits_settled and usage.credits_charged separately from the estimate to reconcile task usage.

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

認証

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

ヘッダー

Idempotency-Keystringオプション<=255 characters

リクエスト

This endpoint expects an object.
model"seedance-2-fast"必須

Must be seedance-2-fast.

promptstring必須1-5000 characters
Video generation instructions.
imageslist of stringsオプション

One first-frame image or first- and last-frame images as public HTTPS URLs.

reference_imageslist of stringsオプション
Public HTTPS image references for multimodal reference generation.
reference_videoslist of stringsオプション
Public HTTPS video references for multimodal reference generation.
reference_audioslist of stringsオプション
Public HTTPS audio references. Audio also requires at least one reference image or video.
durationintegerオプション4-15デフォルト値 5
Requested output duration in seconds.
aspect_ratioenumオプションデフォルト値 adaptive
Output video aspect ratio.
resolutionenumオプションデフォルト値 720p
Output resolution tier.
許可された値:
generate_audiobooleanオプションデフォルト値 true
Generate synchronized audio with the video.

レスポンス

Video generation task accepted

エラー

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error