seedinteger
Random seed for reproducible results. Omit or use -1 for a random seed.
Minimum: -1
Maximum: 4294967295
Seedance 2.5 Text to Video
20% OFF
bytedance/seedance/2.5/text-to-videoByteDance's next-generation text-to-video model, generating native single-shot clips up to 30 seconds at 720p with coherent motion, native audio, and director-level camera control for professional-grade video creation.
Try the model
Playground
Input
The text prompt to generate a video from.
Additional Settings More
Customize your input with more control.
Output duration in seconds (4-30), or `auto` to let the model pick a length from the prompt and inputs. `auto` is pre-authorized at 30 seconds and billed on the actual output length. Allowed values: auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30.
Output aspect ratio. Defaults to 16:9. Allowed values: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.
The resolution of the video to generate. Allowed values: 480p, 720p, 1080p.
Whether to generate synchronized audio (voice, SFX, BGM) for the video.
Random seed for reproducible results. Omit or use -1 for a random seed. Range: -1 to 4294967295.
Draft mode step 1: render a fast, low-cost 480p draft (overrides `resolution`, billed at the 480p rate). Pass the result's `outputs[0].draft_id` back as `draft_id` within 7 days to render the same shot at 1080p.
Draft mode step 2: the `outputs[0].draft_id` of a succeeded draft from this same model (created with `draft: true` in the last 7 days). Renders the same shot at 1080p, billed at the 1080p rate for the actual output length. The prompt, media, duration, aspect ratio, seed, audio setting and task type are reused from the draft; any such fields sent with `draft_id` are ignored.
ResultExample
What would you like to do next?
Examples
Select an example to load its inputs and result into the playground.
- Open result ↗
Input
{ "aspect_ratio": "16:9", "duration": 5, "prompt": "A bright modern kitchen with one wooden dining chair standing in the middle of the tiled floor. A round black robot vacuum glides across the floor, reaches the chair, steers around its legs, passes briefly behind them and reappears on the other side, continuing in the same direction. Static wide camera, no people, realistic lighting.", "resolution": "720p" }
Human preference
Arena
Elo ratings from blind side-by-side votes, compared with other image and video models.
Rankings sourced from Artificial Analysis Arena
- Leaderboard
- Text to Video
- Rank
- #6 of 33
- Elo
- 1104 ±17
- Gap to #1
- −39
Text-to-video arena (silent): people pick the better of two clips from the same prompt, without seeing the model names; audio is not judged.
- #1HeyGen Video 11143±16
- #2MiniMax H3 Max1140±19
- #3FLUX 3 Max1138±19
- #4Wan 3.01133±17
- #5MiniMax H3 (768p)1120±17
- #6Dreamina Seedance 2.51104±17
- #7FLUX 31091±17
- #8Dreamina Seedance 2.01082±17
- #9Gemini Omni Flash 1.11067±17
- #10Agnes-Video-2.51054±17
Seedance 2.5 Text to Video
Seedance 2.5 text-to-video, ByteDance's newest video model: coherent single-shot clips up to 30 seconds with native audio and director-level camera control. Write the scene, including dialogue and sound, and get back a 4–30 second clip.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 50,000 characters. |
duration | auto / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 | 5 | Output length in seconds (4–30), or auto to let the model choose. |
aspect_ratio | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 | 16:9 | Output frame shape. |
resolution | 480p / 720p / 1080p | 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
You pay for output seconds: $0.18 at 480p, $0.36 at 720p, $0.90 at 1080p. Audio is included. With duration: "auto" the quote assumes 30 seconds and the final charge uses the generated length.
| Output | 480p | 720p | 1080p |
|---|---|---|---|
| 4s | $0.72 | $1.44 | $3.60 |
| 5s (default) | $0.90 | $1.80 | $4.50 |
| 10s | $1.80 | $3.60 | $9.00 |
| 15s | $2.70 | $5.40 | $13.50 |
| 30s | $5.40 | $10.80 | $27.00 |
Failed runs are not charged.
Prompting
- Describe subject, action, camera move, and light in order; add the sound last.
- Quote dialogue and name the speaker.
- For several shots, number them and give each a camera direction.
Limits
- Clips are 4–30 seconds.
Draft mode
Draft mode is two calls to this same model:
- Draft: add
"draft": true. The output is a 480p preview billed at the 480p rate, andoutputs[0].draft_ididentifies it. - Final: send
{"draft_id": "<outputs[0].draft_id>"}(optionallywatermark). The same shot is rendered at 1080p and billed at the 1080p output rate for the actual output length.
The final reuses the draft's prompt, media, duration, aspect ratio, seed and audio setting; those fields are ignored when draft_id is set. A draft can be finalized within 7 days, only with the model that created it.
{"prompt": "A red toy sailboat drifts slowly from left to right across calm blue water. Fixed camera.", "duration": 4, "aspect_ratio": "16:9", "generate_audio": false, "draft": true}
{"draft_id": "<outputs[0].draft_id from the draft>"}
Also on SandBase
Other Seedance 2.5 endpoints and tiers: bytedance/seedance/2.5/image-to-video, bytedance/seedance/2.5/reference-to-video, bytedance/seedance/2.0/text-to-video, bytedance/seedance/2.0/fast/text-to-video, bytedance/seedance/2.0/mini/text-to-video.
Start building
Send your first request
Submit this model through the SandBase Unified Run API.
# 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.5/text-to-video",
"draft": false,
"prompt": "Photorealistic style: Under a clear blue sky, a vast expanse of white daisy fields stretches out. The camera gradually zooms in and finally fixates on a close-up of a single daisy, with several glistening dewdrops resting on its petals.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"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"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
draftboolean
Draft mode step 1: render a fast, low-cost 480p draft (overrides `resolution`, billed at the 480p rate). Pass the result's `outputs[0].draft_id` back as `draft_id` within 7 days to render the same shot at 1080p.
Default: false
promptstring
The text prompt to generate a video from.
Default: "Photorealistic style: Under a clear blue sky, a vast expanse of white daisy fields stretches out. The camera gradually zooms in and finally fixates on a close-up of a single daisy, with several glistening dewdrops resting on its petals."
draft_idstring
Draft mode step 2: the `outputs[0].draft_id` of a succeeded draft from this same model (created with `draft: true` in the last 7 days). Renders the same shot at 1080p, billed at the 1080p rate for the actual output length. The prompt, media, duration, aspect ratio, seed, audio setting and task type are reused from the draft; any such fields sent with `draft_id` are ignored.
durationvalue
Output duration in seconds (4-30), or `auto` to let the model pick a length from the prompt and inputs. `auto` is pre-authorized at 30 seconds and billed on the actual output length.
Default: 5
Possible values: "auto", 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
resolutionstring
The resolution of the video to generate.
Default: "720p"
Possible values: "480p", "720p", "1080p"
aspect_ratiostring
Output aspect ratio. Defaults to 16:9.
Default: "16:9"
Possible values: "16:9", "9:16", "1:1", "4:3", "3:4", "21:9"
generate_audioboolean
Whether to generate synchronized audio (voice, SFX, BGM) for the video.
Default: true
{
"model": "bytedance/seedance/2.5/text-to-video",
"draft": false,
"prompt": "Photorealistic style: Under a clear blue sky, a vast expanse of white daisy fields stretches out. The camera gradually zooms in and finally fixates on a close-up of a single daisy, with several glistening dewdrops resting on its petals.",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"poster": "https://static.sandbase.ai/examples/posters/b974c471cd40a0a7918a.jpg",
"source": "Self organization completed prediction",
"source_url": "https://www.sandbase.ai",
"url": "https://static.sandbase.ai/examples/14651a25-543d-406f-aa58-29916f2e9f33/output/af082fa5-7dd3-4a26-a0d8-de1e9d0d65eb.mp4"
}
]