About Seedance 2.5 Flash
Seedance 2.5 Flash is the Flash tier of ByteDance's Seedance 2.5. It makes 4 to 30 second clips at 480p or 720p from a written prompt, a starting image or your own reference images, clips and audio, with a native soundtrack you can switch off at no change in price, and it can extend a clip or edit one you already have with a plain instruction.
Call it with the model name bytedance/seedance-2.5-flash/reference-to-video on POST /jobs/createTask, from $0.385.
Introduction
What Seedance 2.5 Flash reference-to-video does
Seedance 2.5 Flash reference-to-video is ByteDance's multi-reference endpoint for the Flash tier of Seedance 2.5. You attach up to 10 images, 5 video clips and 5 audio files, and the prompt says what each contributes to a new 4 to 30 second scene at 480p or 720p, with sound.
A reference supplies identity, product look, camera behaviour or voice; none becomes the opening frame, so a shot that must start on one exact picture belongs on image-to-video. BytePlus, ByteDance's cloud platform, describes Flash as "results close to flagship Seedance 2.5, with nearly twice the generation speed", at 480p and 720p only.
Request example
Each type is numbered on its own in list order: the portrait is @Image 1, the clip @Video 1, the voice file @Audio 1.
{
"model": "bytedance/seedance-2.5-flash/reference-to-video",
"input": {
"prompt": "The man from @Image 1 walks past the vintage car at the roadside gas station from @Video 1, filmed with the same slow camera move. He stops by the pump, looks into the lens and says a short friendly greeting in the voice from @Audio 1.",
"reference_image_urls": ["https://example.com/man-portrait.jpg"],
"reference_video_urls": ["https://example.com/gas-station-1280x720.mp4"],
"reference_audio_urls": ["https://example.com/greeting-voice.mp3"],
"duration_seconds": 4,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}Response example
Submission returns {"code": 200, "msg": "success", "data": {"taskId": "YOUR_TASK_ID", "state": "queued"}}. Poll GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID or pass a callBackUrl; a finished task looks like this:
{"code": 200, "msg": "success", "data": {"taskId": "YOUR_TASK_ID", "state": "succeeded", "output": {"assets": [{"url": "https://example.com/seedance-flash-reference.mp4"}]}}}Parameters
| Parameter | Values |
|---|---|
prompt | Required; names uploads as @Image 1, @Video 1, @Audio 1 |
reference_image_urls | Up to 10 images |
reference_video_urls | Up to 5 clips, 30 s in total, each at least about 409,600 pixels |
reference_audio_urls | Up to 5 audio files, 30 s in total |
duration_seconds | 4 to 30, default 5 |
resolution | 480p or 720p, default 720p |
aspect_ratio | 16:9 (default), 9:16, 4:3, 3:4, 1:1, 21:9, adaptive |
generate_audio, watermark, return_last_frame, output_format | true, false, false, mp4 by default (mov also) |
Send at least one image, clip or audio file; there is no image_url field here.
Tips for good results
Give every reference a job; a bare tag leaves the model guessing:
| Name | Job | Wording we used |
|---|---|---|
@Image 1 | Identity | "The man from @Image 1" |
@Image 2 | Product | "the glass dropper bottle from @Image 2" |
@Video 1 | Camera move | "filmed with the same slow camera move" |
@Audio 1 | Voice | "in the voice from @Audio 1" |
Write the name with a space, as in @Image 1, the form our examples use. Numbers count per type, so the clip at the top of your video list is @Video 1 whatever the number of images.
Ask for the face. In one test, a portrait, a 4-second clip and an audio file gave the clip's street, yellow tram and tracking camera, but the person stayed back-to-camera and the face of @Image 1 barely showed. Say where the face goes, as "looks into the lens" does in the gas-station example.
Decide what the clip carries. The setting came along with the camera move in that test; to take only the move, say so.
What our tests showed
All on 13 November 2026 at 480p, 4 seconds, audio on.
| References | Result | Time |
|---|---|---|
| Portrait, 1280×720 clip of 5.04 s, voice file | 854×480, 4.064 s; the man passes the vintage car and smiles at the lens | 2.5 min |
| 2 images (man, dropper bottle), 9:16 | 480×854; he lifts the bottle and turns it to the camera, both references used | 5.4 min |
| Portrait, 4 s clip, audio file | Street, tram and camera kept; person back-to-camera | 9.4 min |
Across all four Flash endpoints, 4-second 480p clips took 84 seconds to about 11 minutes; 720p or longer clips take longer. These Flash-only timings neither confirm nor dispute BytePlus's comparison with Seedance 2.5.
Limits and errors
| Limit | What happens | What to do |
|---|---|---|
| Over 10 images, 5 clips or 5 audio files, or clips over 30 s in total | Validation fails | Keep references that carry a job; trim clips |
Use only faces, voices and footage you have the right to use, and do not present a generated person as someone real. The model runs its own copyright and likeness checks and can decline a request.
When to choose a sibling
- Flash image-to-video: one exact picture must open the shot.
- Flash text-to-video for a prompt alone; Flash video edit to change an existing clip.
- Seedance 2.5: delivery above 720p, 4K or clip extension.
- Seedance 2.0 Fast: previous-generation fast tier with extend.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive · Default: 16:9 |
duration_seconds | No | Length of the generated clip. ≥ 4 · ≤ 30 · Default: 5 |
generate_audio | No | Adds sound made to match the picture: voices, ambience and effects. Default: true |
output_format | No | File type of the result. mp4 · mov · Default: mp4 |
prompt | Yes | Describe what you want to make. |
reference_audio_urls | No | Audio to match: a voice, music or a rhythm. |
reference_image_urls | No | Pictures of the people, outfits or places the result should keep. |
reference_video_urls | No | Clips whose motion, camera or style the result should follow. |
resolution | No | Choose an available output size. 480p · 720p · Default: 720p |
return_last_frame | No | Also save the clip’s final frame as a picture. Default: false |
watermark | No | Add a visible “AI generated” watermark. Default: false |
Pricing
Prices are in USD and charged to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
| Option | USD per second |
|---|---|
| resolution 480p · with_video true | $0.077 |
| resolution 480p · with_video false | $0.116 |
| resolution 720p · with_video true | $0.147 |
| resolution 720p · with_video false | $0.224 |
Send the same request body to POST /jobs/quote to see the estimated and maximum USD charge before running. A quote does not run the task or charge your balance.
API quick start
Call the Seedance 2.5 Flash API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow-. API calls are billed in USD from your PopNow balance.
- Send the request. POST /jobs/createTask with model bytedance/seedance-2.5-flash/reference-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.5-flash/reference-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://media.popnow.ai/influencer/examples/ava.webp"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration_seconds": 5
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Seedance 2.5 Flash API questions
How much does the Seedance 2.5 Flash API cost?
Seedance 2.5 Flash starts at $0.385 for a 5-second clip with Reference to Video, its lowest-priced task. Prices by option: 480p · true $0.077 per second, 480p · false $0.116 per second, 720p · true $0.147 per second, 720p · false $0.224 per second. API usage is charged in USD to your PopNow balance. When a task is accepted, we reserve the maximum quoted amount from your API balance. On completion, we charge for actual usage, never more than the hold, and release the remainder. If the task fails, the hold is released.
What are the limits of the Seedance 2.5 Flash · Reference to Video API?
Clip length: 4–30 s; Resolutions: 480p · 720p; Aspect ratios: 16:9 · 9:16 · 4:3 · 3:4 · 1:1 · 21:9 · adaptive; Reference audio: 5; Reference images: 10. Requests outside these limits are rejected before anything is charged.