seedance-2.5 AI Video API
ByteDance Seedance 2.5 is an audio-video generation model for text-to-video and image-to-video workflows. Use reference media, first/last-frame controls, 4–30-second requests, and optional audio through Flatkey's /v1/videos endpoint.
Input
Output
PreviewGenerated with Seedance 2.0
Request summary
- Endpoint
- POST /v1/videos
- Model ID
- seedance-2.5
- Aspect ratio
- 16:9
- Resolution
- 720p
- Duration
- 5s
- Generate audio
- On
- Reference media
- None
Preview only. Sign in to submit this request to Flatkey.
{
"model": "seedance-2.5",
"content": [
{
"type": "text",
"text": "Creative direction: A lone performer silhouette stands on a low black stage while luminous ribbons sweep across the backdrop. Teal waves arrive first, followed by amber light ribbons that curl into layered arcs, ending in a centered wide composition around the figure.\n\nVisual treatment: Stage-projection visual with a black silhouette and layered teal-to-amber light.\n\nShot sequence: 1. Establish the lone silhouette on the black stage.; 2. Sweep teal ribbons behind the figure, then introduce amber arcs.; 3. Complete the layered arcs and hold the centered wide stage.\n\nContinuity: Keep the main subject, palette and light behavior consistent as the visual pattern develops.\nExclude: extra people or props, text, logos and watermarks."
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true
}Performance
Seedance 2.5 AI video API performance and availability
Live request telemetry appears here when enough Flatkey traffic is available.
Activity
Seedance 2.5 video API usage activity
Only live Flatkey request data is shown here; a chart appears after enough traffic is collected.
Pricing
seedance-2.5 API Pricing
Prices below are calculated from Flatkey pricing data for this model and the visible groups currently returned by our pricing API.
Add credits
Use the same Flatkey balance and API key across image, video, audio, and text models.
- Provider
- ByteDance
- API
- /v1/videos
- Duration
- 4–30s
- Billing basis
- second
Seedance 2.5 AI video generator features for references and audio
The documented contract covers text-to-video and image-to-video inputs, reference media, optional audio, and bounded output settings.
Text-to-video and image-to-video
Start from a written scene or supply reference images for a subject, product, or storyboard you have already designed.
Reference media and frame control
The request can include image, video, and audio references, plus first-frame and last-frame roles for reference-led workflows.
Audio-video generation
Enable audio generation as an explicit request option; do not assume a language list or audio behavior that the selected route does not document.
Duration and output controls
Choose 4–30 seconds, 480p or 720p, adaptive or supported fixed ratios, and the audio setting before submitting the task.
Compare
Compare Seedance 2.5 with Seedance 2.0: documented video fields
This comparison records documented Seedance 2.5 behavior. Seedance 2.0 values are marked as not verified rather than inferred.
| Capability | Seedance 2.0 (not re-audited) | Seedance 2.5 |
|---|---|---|
| Clip length | Not verified in this audit | 4–30 seconds per request |
| Reference inputs | Not verified in this audit | Up to 50 total: 30 images, 10 videos, and 10 audio |
| Frame control | Not verified in this audit | First-frame and last-frame roles are supported |
| Audio | Not verified in this audit | Audio generation can be enabled per request |
| Editing workflow | Not verified in this audit | Reference-guided and first/last-frame workflows |
Choose the right request before you integrate
Review the supported workflows, live cost for the current setup, and the exact parameter contract used by Flatkey.
Calculated from the current Playground settings and the live catalog rate when a fixed unit price is available.
- Current setup
- 720p · 5s
- Live rate
- from $0.188 / second · 4s min
- Estimated request
- $0.940 $0.188 × 5s
The final charge follows the submitted request and your account group. Token-priced or tiered requests cannot be reduced to one fixed estimate.
Workflows and Model ID
Use only the workflows marked available. Flatkey keeps one public model ID while the request body selects the input workflow.
Text to Video
Create a clip from a text prompt and supported output controls.
- Model ID
seedance-2.5- Endpoint
/v1/videos
Image to Video
Animate one or more image references while preserving the requested subject and composition.
- Model ID
seedance-2.5- Endpoint
/v1/videos
Reference to Video
Guide the result with the documented image, video, or audio reference inputs.
- Model ID
seedance-2.5- Endpoint
/v1/videos
Video Edit
Transform an existing clip when this route exposes video editing.
- Model ID
seedance-2.5- Endpoint
/v1/videos
Video Extend
Continue an existing clip when this route exposes video extension.
- Model ID
seedance-2.5- Endpoint
/v1/videos
Parameter compatibility
These values come from the same model configuration used by the Playground and request preview.
resolutionResolution480p · 720p
Default: 720pratioAspect ratioadaptive · 16:9 · 4:3 · 1:1 · 3:4 · 9:16
Default: adaptivedurationDuration4–30
Default: 5generate_audioGenerate audioOn · Off
Default: OnimageReference limit30 files
Endpoint: /v1/videosvideoReference limit10 files
Endpoint: /v1/videosaudioReference limit10 files
Endpoint: /v1/videosFrom first test to production
Use the same request contract in the Playground and API, then handle validation, balance, task state, and output retrieval explicitly.
Request lifecycle
- 1
Validate the model, prompt, references, and output settings.
- 2
POST the request and retain the returned task ID.
- 3
Poll task status or process the configured callback.
- 4
Fetch the generated file from the content endpoint and store it before expiry.
Production checks
Reject unsupported sizes, durations, ratios, formats, or reference counts before submitting.
Handle invalid keys, insufficient balance, rate limits, and account-group pricing separately.
Surface the rejected prompt or asset clearly so the user can replace only the failing input.
Keep the task ID, use bounded retries, and never treat a timeout as a successful generation.
Prompt library
Seedance 2.5 prompt guide for text-to-video and image-to-video
Use these workflow-specific prompts as starting points. Output depends on the supplied references and request settings.
Generated with Seedance 2.0
Creative direction: An anime student traces a winding black route across an aged parchment map at a wooden table inside a quiet library. The camera eases closer as warm specks of light appear between the bookshelves, then holds on the student's hand and the illuminated map. Visual treatment: Hand-drawn anime with warm library tones and restrained magical light. Shot sequence: 1. Establish the student, parchment and shelf depth.; 2. Follow the fingertip along the black route as warm light specks emerge.; 3. Ease into the illuminated map and hold the hand in focus. Continuity: Keep the character's face, clothing and key prop consistent; preserve screen direction across cuts. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A cream-enamel travel kettle with brushed-metal accents is presented on a warm gray studio surface. Its body, handle, spout and lid assemble through visible mechanical connections; once seated, a small plume of steam leaves the spout. The final frame shows the complete kettle from a clean three-quarter angle. Visual treatment: Photoreal product animation. A soft overhead key defines the enamel, and a narrow side light traces the brushed-metal edges. Shot sequence: 1. Show the separated parts and their connection points; 2. Assemble body, handle, spout and lid in a clear order without changing their shapes; 3. Hold the finished kettle as steam rises from the spout Continuity: Keep the product silhouette, cap or hinge, materials and prop positions stable; hold the final hero frame. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A white armored sci-fi rover rolls through a dusty landscape toward a monumental dark structure. Start close on its massive treaded wheel, track beside the moving vehicle as dust lifts, then widen to reveal the rover's destination. Visual treatment: Photoreal science-fiction previs with weathered armor, dusty air and monumental scale. Shot sequence: 1. Track the rotating tread from a low close-up.; 2. Continue alongside the white rover as its wheels throw dust backward.; 3. Widen to include the monumental dark destination without reversing travel direction. Continuity: Maintain scene geography, subject scale and motivated light direction throughout the camera move. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A cloaked traveler stands on a rust-colored canyon ridge at sunset. Move from a side view to behind the figure, revealing a vast settlement and a long curved structure across the canyon, then hold the traveler as a clear foreground silhouette. Visual treatment: Rendered fantasy game cinematic with rust-colored terrain and sunset backlight. Shot sequence: 1. Frame the cloaked traveler in profile on the ridge.; 2. Arc slowly behind the traveler to reveal the settlement and curved structure.; 3. Rest behind the foreground silhouette with the canyon open beyond. Continuity: Maintain character design, equipment geometry and travel direction from first to final frame. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A realistic hand touches a glowing lavender planet model on a black reflective tabletop. Concentric rings spread from the fingertip and small moons begin orbiting the sphere while the camera holds a close three-quarter view of the reflection. Visual treatment: Photoreal tabletop demonstration with controlled lavender emission and a dark reflection. Shot sequence: 1. Frame the lavender sphere and its tabletop reflection.; 2. Bring the fingertip into contact and expand concentric light rings from that point.; 3. Let the small moons orbit while the three-quarter camera remains still. Continuity: Keep demonstration props, layout and hand contact consistent so the action remains legible. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A lone performer silhouette stands on a low black stage while luminous ribbons sweep across the backdrop. Teal waves arrive first, followed by amber light ribbons that curl into layered arcs, ending in a centered wide composition around the figure. Visual treatment: Stage-projection visual with a black silhouette and layered teal-to-amber light. Shot sequence: 1. Establish the lone silhouette on the black stage.; 2. Sweep teal ribbons behind the figure, then introduce amber arcs.; 3. Complete the layered arcs and hold the centered wide stage. Continuity: Keep the main subject, palette and light behavior consistent as the visual pattern develops. Exclude: extra people or props, text, logos and watermarks.
Why Flatkey
Use Seedance 2.5 through a unified video API
Use one key for the model catalog, inspect the request contract, and keep pricing tied to the selected settings.
One key for the model catalog
Use the same Flatkey account and API key across video, image, audio, and text workloads.
Documented video contract
Keep Seedance's content[] request, /v1/videos endpoint, and asynchronous task flow explicit in your integration.
Pricing follows the request
Resolution, duration, and video-reference input change the formula; the catalog value is not a universal per-second promise.
Live data only when available
Performance and activity cards show telemetry when enough real Flatkey traffic exists, otherwise they stay unreported.
API
Use the Seedance 2.5 API at /v1/videos
Send Seedance content[] items, keep the task id, and fetch the result from /v1/videos/{task_id}/content.
curl https://router.flatkey.ai/v1/videos \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"seedance-2.5","content":[{"type":"text","text":"A cinematic product shot of a sports car on a wet track, soft studio lighting, high detail."}],"ratio":"adaptive","resolution":"720p","duration":5,"generate_audio":true}' # Poll for the result (replace TASK_ID with the returned task id) curl "https://router.flatkey.ai/v1/videos/TASK_ID" \ -H "Authorization: Bearer sk-***"
FAQ
Seedance 2.5
API, pricing, and release-date questions
Pricing, compatibility, limits, and how your prompts and generated files are handled.