bytedance/seedance/2.0/fast/reference-to-video

Name: Seedance 2.0 Fast Reference to Video
Author: Bytedance

ByteDance's most advanced reference-to-video model in its fast tier delivering lower latency and cost without compromising on cinematic output, native audio, multi-shot editing, and director-level camera control for pro...

Input

Prompt(string)

The text prompt to generate a video from.

Image URL or upload(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

The URLs of reference images to guide video generation.

Videos(array)

The URLs of reference videos to guide video generation. Up to 3 MP4 or MOV files, 2-15 seconds combined duration, under 50 MB total.

Audios(array)

The URLs of reference audio files to guide video generation.

Duration(integer)

The duration of the generated video in seconds. Allowed values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

Aspect Ratio(string)

The aspect ratio of the generated video. Allowed values: 16:9, 9:16, 1:1, 4:3, 3:4.

Resolution(string)

The resolution of the video to generate. Allowed values: 480p, 720p.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDbytedance/seedance/2.0/fast/reference-to-video

Input Schema

7 parameters · 1 required · 6 optional

Parameter	Type	Required	Description
`prompt`	string	Required	The text prompt to generate a video from. · Min length: 3 · Max length: 50000 · Default: "Room is slowly getting filled from empty state to fully organized with furnitures. Camera is fixed timelapse."
`audios`	string[]	Optional	The URLs of reference audio files to guide video generation.
`images`	string[]	Optional	The URLs of reference images to guide video generation.
`videos`	string[]	Optional	The URLs of reference videos to guide video generation. Up to 3 MP4 or MOV files, 2-15 seconds combined duration, under 50 MB total.
`duration`	integer	Optional	The duration of the generated video in seconds. · Options: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 · Default: 5 456789101112131415
`resolution`	string	Optional	The resolution of the video to generate. · Options: 480p, 720p · Default: "720p" 480p720p
`aspect_ratio`	string	Optional	The aspect ratio of the generated video. · Options: 16:9, 9:16, 1:1, 4:3, 3:4 16:99:161:14:33:4

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, or timeout
Retrieve — Read outputs from the completed response

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/fast/reference-to-video",
  "images": [
    "https://static.sandbase.ai/examples/bfl/flux-1/fill/input_image_0.jpeg",
    "https://static.sandbase.ai/examples/alibaba/wan/2.2/animate/replace/input_image_0.png"
  ],
  "prompt": "Room is slowly getting filled from empty state to fully organized with furnitures. Camera is fixed timelapse.",
  "duration": 5,
  "resolution": "720p"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Seedance 2.0 Fast Reference to Video

API README

Seedance 2.0 Fast Reference to Video

ByteDance's fast-tier reference-to-video model — generates video from multiple reference inputs (images, videos, audio) with lower latency and ~20% cost savings.

Need higher resolution (1080p)? Try Seedance 2.0 Reference to Video.
Need text-only generation? Try Seedance 2.0 Fast Text to Video.
Need image-driven generation? Try Seedance 2.0 Fast Image to Video.

Highlights

Lower latency — Optimized for speed, ideal for iterative workflows and rapid prototyping.

Multi-reference input — Combine images, videos, and audio references to guide generation.

Native audio generation — Automatically creates synchronized sound effects and ambient audio.

Up to 720p — Supports 480p and 720p output (1080p not available in fast tier).

Pricing

Non-4K rates use Volcengine's non-promotional list price converted at 1 USD = 6.74 CNY. All 4K output rates use the confirmed reference price.

Resolution	Output price per second	Input-video price per second
480p	$0.05	$0.03
720p	$0.12	$0.07

Default: 5 output seconds at 720p = $0.59. Video references add the input-video rate using the server-probed trusted aggregate input duration. Only the exact Seedance 2.0 standard, Fast, and Mini reference-to-video modes and Seedance 2.5 reference-to-video mode, each with non-empty videos, explicitly use the isolated lenient-duration policy; the default media probe, Webhook validation, empty-video requests, and every other model or caller remain strict. Every legal domain in this isolated policy uses the system resolver, standard HTTP transport, and ProxyFromEnvironment without all-address public-DNS validation, IP pinning, or DNS-rebinding protection. Each redirect hop repeats the base URL and redirect validation. Invalid URL or host, redirect-policy, count-limit, per-item or aggregate size-limit, parser-resource-limit, and successfully parsed aggregate duration-limit failures fail closed. All other fixed failures—dns_unavailable, connect_error, network_timeout, tls_error, http_status, download_error, empty_body, mime_mismatch, magic_mismatch, unsupported_media, malformed_media, and duration_unavailable—use the 15-second family cap for the whole request once, not per video. Logs and errors expose only fixed stage/reason, video index/count, host hash, bytes, elapsed time, fallback marker, and policy version; complete URLs, queries, signatures, response bodies, and media content remain redacted. New requests freeze trusted-probe policy v4; existing v3, v2, and legacy predictions retain their frozen settlement semantics. This isolated application policy requires no new server, Kubernetes, proxy, egress, or environment configuration. Image and audio references do not add this video-input charge. Audio generation is included at no extra cost.

Technical Specs

Spec	Value
Input	Images + videos + audio + optional text
Output	MP4 video with optional audio
Resolution	480p / 720p
Aspect ratios	16:9, 9:16, 1:1, 4:3, 3:4, 21:9
Duration	4–15 seconds
Execution	Async (submit → poll for result)
Typical latency	1–5 minutes

Seedance 2.0 Reference to Video — Standard version with 1080p support
Seedance 2.0 Fast Text to Video — Fast text-driven generation
Seedance 2.0 Fast Image to Video — Fast image-driven generation