Seedance 2 Fast Reference to Video
Generate videos from your own reference material with Seedance 2 Fast by ByteDance — up to 9 reference images, 3 reference videos, and 3 audio tracks per generation. Mention references in your prompt as 'image 1', 'video 1', and so on for character consistency, motion transfer, and audio-driven clips at the fast tier's lower cost.
76% less than the priciest provider (5 compared). Same model, same output.
Up to 9 reference images for character, style or scene. Cite in the prompt as @Image1 and so on.
Up to 3 reference videos (mp4/mov), total duration up to 15s. Reference video seconds are billed as input.
Up to 3 reference audio files (wav/mp3). Requires at least one reference image or video.
Duration
Duration of the video in seconds (4-15). Billed per second.
Resolution
Video resolution. Higher resolutions cost more per second.
Aspect Ratio
Aspect ratio of the generated video. 'adaptive' follows the prompt or the primary media.
Audio
Synchronized audio: voice, sound effects and music generated in the same pass. Some sellers cannot switch audio off, so turning it off can change the winning price.
Content
What the video contains. Sellers differ in what they allow: 'general' (no faces) can unlock lower prices; 'mature' routes only to sellers without content restrictions.
76% less than the priciest provider (5 compared). Same model, same output.
Your result renders here.
Use Seedance 2 Fast Reference to Video via the API
Generate with Seedance 2 Fast Reference to Video from your own code. Async by design: submit a generation, get a run id back instantly, poll until it completes. Billed in credits at the best available provider price — from $0.09 per second, audio included.
1 — Start a generation
curl -X POST https://app.scenetra.com/api/v1/generate/seedance-2-ref2v-fast \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt":"@Image1 walks through a sunlit market holding @Image2, handheld follow shot, crowd murmur","reference_images":["https://example.com/person.jpg","https://example.com/product.jpg"],"duration":"5"}'Response (202)
{
"runId": "run_abc123",
"status": "PENDING",
"model": "seedance-2-ref2v-fast",
"estimatedCredits": 293,
"statusUrl": "/api/v1/runs/run_abc123"
}2 — Poll until COMPLETED (every 2-5 seconds)
curl https://app.scenetra.com/api/v1/runs/run_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"runId": "run_abc123",
"status": "COMPLETED",
"progress": { "completed": 1, "total": 1 },
"outputs": [
{ "type": "video", "url": "https://images.scenetra.com/..." }
],
"error": null,
"estimatedCredits": 293
}Request fields
| Field | Type | Description | Default |
|---|---|---|---|
| prompt* | string | Cite reference inputs in order with @-syntax: @Image1, @Video1, @Audio1. | — |
| reference_images | string[] (https URLs) | Up to 9 reference images for character, style or scene. Cite in the prompt as @Image1 and so on. | — |
| reference_videos | string[] (https URLs) | Up to 3 reference videos (mp4/mov), total duration up to 15s. Reference video seconds are billed as input. | — |
| reference_audios | string[] (https URLs) | Up to 3 reference audio files (wav/mp3). Requires at least one reference image or video. | — |
| duration | string | Duration of the video in seconds (4-15). Billed per second.4 · 5 · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 | 5 |
| resolution | string | Video resolution. Higher resolutions cost more per second.480p · 720p | 720p |
| aspect_ratio | string | Aspect ratio of the generated video. 'adaptive' follows the prompt or the primary media.adaptive · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | adaptive |
| generate_audio | string | Synchronized audio: voice, sound effects and music generated in the same pass. Some sellers cannot switch audio off, so turning it off can change the winning price.false · true | true |
| subject_content | string | What the video contains. Sellers differ in what they allow: 'general' (no faces) can unlock lower prices; 'mature' routes only to sellers without content restrictions.general · people · mature | people |
| callbackUrl | string (https URL) | Optional. When the run finishes (completed or failed), we POST the final run status to this URL — same shape as the poll response, plus model, params, and chargedCredits. Best-effort; polling remains the source of truth. | |
Unknown fields are rejected with a helpful 400. Media fields take https URLs. There is no provider parameter — every run is routed to the cheapest capable provider automatically.
Good to know
Billing
Runs bill your account credits at provider cost with 0% markup. The submit response includes the credit estimate; failed generations are refunded automatically. Add ?dryRun=1 to get the estimate without running anything.
Errors
Errors are always { "error": { "code", "message" } } with stable codes: unauthorized, model_not_available, invalid_parameter, insufficient_credits, rate_limited. A failed run is not an HTTP error — poll responses report status: "FAILED" with the reason.
What makes Seedance 2 Fast Reference to Video different
The iteration tier of Seedance 2
Seedance 2 Fast is the same cinematic Seedance 2.0 family tuned for speed and cost: roughly 20% cheaper per second than the full model at both 480p and 720p, with quicker turnaround. It's built for the exploratory phase — trying prompts, blocking shots, testing motion — where you generate ten clips to keep one.
Synchronized audio at no extra cost
Like its bigger sibling, Fast generates voice, sound effects, and background music together with the picture in a single pass — and the per-second price is identical with audio on or off. Leave the toggle on for sound-on drafts, or flip it off for silent footage; either way you pay the same rate.
4 to 15 seconds, priced per second
Choose any whole-second duration from 4 to 15 and pay only for what you generate: a 5-second 480p draft is about $0.45, a 10-second one about $0.90. Aspect ratios run from 21:9 cinematic wide to 9:16 vertical, or stay on Auto and let the prompt decide the frame.
Draft on Fast, finish on Seedance 2
Fast caps at 720p, while the full Seedance 2 adds a 1080p super-resolution tier. On a Scenetra board the two sit side by side: iterate your prompt on a Seedance 2 Fast node until the shot works, then paste the winning prompt into a Seedance 2 node for the full-quality 1080p final — same settings, same canvas.
Parameters
| Parameter | Type | Description | Default |
|---|---|---|---|
| Prompt* | text | Text prompt describing the video to generate. | — |
| Duration | select | Duration of the video in seconds (4-15).4 · 5 · 6 · 7 · 8 · 9 · 10 · 11 · 12 · 13 · 14 · 15 | 5 |
| Resolution | select | Video resolution. Higher resolutions cost more per second.480p · 720p | 720p |
| Aspect Ratio | select | Aspect ratio of the generated video, or 'Auto' to let the model choose from prompt context.Auto · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | Auto |
| Generate Audio | select | Whether to generate synchronized audio — voice, sound effects, and music — with the video.false · true | true |
| Content | select | What your video contains. 'No faces' can unlock lower prices; 'Mature' relaxes content restrictions.No faces · Faces · Mature | Faces |
Pricing
From $0.09 per second, audio included
Pay per generation — only pay for what you use.
480p
$0.09/s
per second
720p
$0.20/s
per second
What a video costs
| Duration | 480p | 720p |
|---|---|---|
| 5 seconds | $0.45 | $0.98 |
| 10 seconds | $0.90 | $1.94 |
Use cases
Rapid prototyping
- Prompt exploration at 480p
- Shot blocking and previz
- Motion tests before finals
- A/B concept batches
Social content
- Vertical 9:16 clips
- Sound-on hooks
- Trend-reactive videos
- High-volume posting schedules
Marketing & ads
- Ad concept testing
- UGC-style spots
- Campaign variant batches
- Storyboard animatics
Film & storytelling
- Scene drafts with dialogue
- Establishing shot sketches
- Beat-by-beat story tests
- Mood and lighting studies
Frequently asked questions
What is Seedance 2 Fast Reference to Video?+
It's the multimodal mode of ByteDance's Seedance 2 Fast — the quick, lower-cost Seedance 2 tier. Instead of starting from just a prompt, you guide the generation with your own reference material: images for characters and style, videos for editing and extension, audio for sound-driven clips. On Scenetra it runs as a node in the visual workflow editor at 480p or 720p.
How many reference files can I use?+
Up to 9 reference images, up to 3 reference videos (mp4 or mov, 15 seconds combined), and up to 3 audio tracks (wav or mp3). Audio references require at least one reference image or video alongside them.
How do I reference my uploads in the prompt?+
Mention them by type and submission order: 'image 1' is your first reference image, 'video 1' your first video, 'audio 1' your first audio track. For example: 'The character from image 1 walks through the scene in image 2.' Naming the references tells the model which asset plays which role.
Can Seedance 2 Fast extend or edit an existing video?+
Yes, within reference limits: supply your footage as a reference video (up to 3 clips, 15 seconds combined) and prompt a continuation, a restyle, or motion transfer onto new subjects. For higher-resolution results, the full Seedance 2 Reference to Video offers the same workflow with a 1080p tier.
How do I keep a character consistent across multiple videos?+
Reuse the same reference images across generations. Upload your character from a few angles, mention them as 'image 1' through 'image 3' in every prompt, and the model keeps the identity stable from clip to clip — and Fast's lower per-second rate makes generating a whole series of takes affordable.
Does Reference to Video generate audio too?+
Yes — like the other Fast modes, it generates synchronized voice, sound effects, and music with the picture by default, and you can toggle audio off for silent output. You can also steer the sound yourself by attaching reference audio tracks alongside at least one visual reference.
Related models
Seedance 2
ByteDance's Seedance 2.0 generates cinematic videos from text prompts with synchronized audio — voice, sound effects, and background music. Pick any duration from 4 to 15 seconds and resolutions up to 1080p, with per-second pricing that keeps 480p drafting cheap.
View model →Seedance 2 Mini
ByteDance's Seedance 2 Mini is the fast, lower-cost tier of Seedance 2 — generating cinematic videos from text prompts with synchronized audio. Mini delivers the same audio-visual sync at a fraction of the price, ideal for rapid iteration and high-volume social content.
View model →Seedance 2.5
ByteDance's Seedance 2.5 generates cinematic videos up to 30 seconds from text prompts with synchronized audio — voice, sound effects, and background music — built in by default. The newest Seedance generation, with mp4 or high-fidelity mov output for multi-round editing pipelines.
View model →Start creating with Seedance 2 Fast Reference to Video
Use Seedance 2 Fast Reference to Video alongside 50+ other AI models in Scenetra's visual workflow editor. No setup required.
Get Started