bytedance/seedance/2.0/mini/reference-to-video
Seedance 2.0 Mini by Bytedance - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.
Input
The text prompt used to generate the video.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12.
Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution.
Video resolution - 480p for faster generation, 720p for balance. Allowed values: 480p, 720p.
Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. Allowed values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not.
The unique user ID of the end user.
Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file.If audio is provided, at least one reference image or video is required.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Idle
Example output — click Run to generate your own
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/runModel ID
bytedance/seedance/2.0/mini/reference-to-video01
Input Schema
9 parameters · 1 required · 8 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | The text prompt used to generate the video. |
images | string[] | Optional | Reference images to guide video generation. Refer to them in the prompt as @Image1, @Image2, etc. Supported formats: JPEG, PNG, WebP. Max 30 MB per image. Up to 9 images. Total files across all modalities must not exceed 12. |
videos | string[] | Optional | Reference videos to guide video generation. Refer to them in the prompt as @Video1, @Video2, etc. Supported formats: MP4, MOV. Up to 3 videos, combined duration must be between 2 and 15 seconds, total size under 50 MB. Each video must be between ~480p (640x640) and ~720p (834x1112) in resolution. |
duration | integer | Optional | Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. · Options: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Default: "auto" 456789101112131415 |
audio_urls | string[] | Optional | Reference audio to guide video generation. Refer to them in the prompt as @Audio1, @Audio2, etc. Supported formats: MP3, WAV. Up to 3 files, combined duration must not exceed 15 seconds. Max 15 MB per file.If audio is provided, at least one reference image or video is required. |
resolution | string | Optional | Video resolution - 480p for faster generation, 720p for balance. · Options: 480p, 720p · Default: "720p" 480p720p |
end_user_id | string | Optional | The unique user ID of the end user. |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
generate_audio | boolean | Optional | Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not. · Default: true |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
03
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "bytedance/seedance/2.0/mini/reference-to-video",
"images": [
"https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
],
"prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
"duration": "auto",
"resolution": "720p",
"generate_audio": true
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
PRICED DRAFT — MANUAL REVIEW REQUIRED exact_model_mode: bytedance/seedance-2.0/mini/reference-to-video original_unit: $0.007/1000 tokens; approx $0.0721/s 480p or $0.1547/s 720p; input video billed at 0.6x method: token price converted to published output-second tiers plus metered aggregate input-video duration at 0.6x result_base_price: 0.7735 result_price_formula: (usage.total_seconds ?? ((params.duration ?? "auto") == "auto" ? 5 : params.duration)) * ((params.resolution ?? "720p") == "720p" ? 0.1547 : 0.0721) + (usage.input_video_seconds ?? 0) * ((params.resolution ?? "720p") == "720p" ? 0.1547 : 0.0721) * 0.6 review_status: pending; model remains disabled checked_at: 2026-08-16