Seedance 2.0 Reference to Video
bytedance/seedance/2.0/reference-to-videoByteDance's most advanced reference-to-video model generating cinematic video guided by reference content, with native audio, multi-shot editing, and director-level camera control for professional-grade video creation.
- Base price
- $0.96
$1.20USD / run - Execution
- async
- Model type
- video
- Input fields
- 9
Try the model
Playground
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.96 / run
Context & modalities
- Input
- Schema-defined
- Output
- video
Capabilities
- Chat
- Not supported
- Vision
- Not supported
- Reasoning
- Not supported
- Structured output
- Not supported
- Function calling
- Not supported
- Audio input
- Not supported
Access
- Provider
- ByteDance
- Model ID
- bytedance/seedance/2.0/reference-to-video
- Execution
- async
- Base URL
- https://api.sandbase.ai
- API
- Unified Run API
- Endpoint
- /v1/run
API README
Seedance 2.0 Reference to Video
Seedance 2.0 reference-to-video: combine reference images, up to 3 reference videos, and reference audio to lock a character, set, motion, or voice in a new clip.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 50,000 characters. |
images | image URL[] | — | Reference images, Image 1, Image 2, … |
videos | video URL[] (≤3) | — | Reference clips (up to 3), Video 1, Video 2, … |
audios | audio URL[] | — | Reference audio, Audio 1, Audio 2, … |
duration | auto / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 | 5 | Output length in seconds (4–15), or auto to let the model choose. |
aspect_ratio | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | — | Output frame shape. |
resolution | 480p / 720p / 1080p / 4k | 720p | Sets the per-second rate. |
generate_audio | boolean | true | Native dialogue, music, and effects. Same price on or off. |
seed | integer -1–4294967295 | random | Fix it to compare prompt changes; -1 is random. |
Billing
Without reference videos you pay for output seconds: $0.12 at 480p, $0.24 at 720p, $0.60 at 1080p, $1.20 at 4k. With reference videos, the input video seconds (at least 2) are added to the output length and billed at a lower rate: $0.075 at 480p, $0.15 at 720p, $0.375 at 1080p, $0.75 at 4k. With duration: "auto" the quote assumes 15 seconds and the final charge uses the generated length.
| Output | 480p | 720p | 1080p | 4k |
|---|---|---|---|---|
| 5s, images only | $0.60 | $1.20 | $3.00 | $6.00 |
| 10s, images only | $1.20 | $2.40 | $6.00 | $12.00 |
| 5s + 5s reference video | $0.75 | $1.50 | $3.75 | $7.50 |
| 10s + 10s reference video | $1.50 | $3.00 | $7.50 | $15.00 |
Failed runs are not charged.
Prompting
- Give each reference a role: “Image 1 is the dancer, Video 1 sets the choreography, Audio 1 is the music”.
- Numbering follows array order within each type.
Limits
- Reference video seconds count toward billing (minimum 2, up to 15).
Also on SandBase
Other Seedance 2.0 endpoints and tiers: bytedance/seedance/2.0/text-to-video, bytedance/seedance/2.0/image-to-video, bytedance/seedance/2.5/reference-to-video, bytedance/seedance/2.0/fast/reference-to-video, bytedance/seedance/2.0/mini/reference-to-video.
Start building
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "bytedance/seedance/2.0/reference-to-video",
"images": [
"https://static.sandbase.ai/examples/bytedance/seedance/2.0/reference-to-video/input_image_safe_ocean_0.jpg"
],
"prompt": "Use Image1 as the visual reference and Video1 as the motion reference. Create a peaceful cinematic shoreline scene with rolling ocean waves at golden hour, soft foam, natural water movement, and no people.",
"videos": [
"https://static.sandbase.ai/examples/pixverse/sound-effects/input_video_0.mp4"
],
"duration": 5,
"resolution": "720p",
"generate_audio": true
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"Choose your model
Compare models
| Model | Type | Default price | Released |
|---|---|---|---|
Seedance 2.0 Reference to VideoThis model ByteDance | Video | $1.20 / run | Apr 1, 2026 |
ByteDance | Video | $0.53 / run | Oct 15, 2026 |
ByteDance | Video | $1.80 / run | Jul 1, 2026 |
ByteDance | Video | $1.80 / run | Jul 1, 2026 |
ByteDance | Video | $1.80 / run | Jul 1, 2026 |
ByteDance | Video | $0.60 / run | Jun 24, 2026 |
Questions
FAQ
How do I call ByteDance Seedance 2.0 Reference to Video through SandBase?
Create a SandBase API key, then send requests with the model ID "bytedance/seedance/2.0/reference-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.
Do I need a separate ByteDance account?
No. One SandBase API key and balance gives you access to ByteDance Seedance 2.0 Reference to Video and the other models in the catalog; you do not need to sign up with ByteDance separately.
