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.

Image to VideoReference-guided VideoAudio generationShort-form Video
Provider
ByteDance
Reference price
480pfrom $0.084 / second · 4s min720pfrom $0.188 / second · 4s min
Flatkey price
480pfrom $0.084 / second · 4s min720pfrom $0.188 / second · 4s min
Generator setup · Playground (edit before sign-up)

Input

PromptCheck more756 / 10000
Quick Prompts
Reference image0 / 30
Reference videos0 / 10
Reference Audios0 / 10
Start generating

Output

Preview

Generated 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.

Request preview
{
  "model": "seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "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.\n\nVisual treatment: Photoreal science-fiction previs with weathered armor, dusty air and monumental scale.\n\nShot 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.\n\nContinuity: Maintain scene geography, subject scale and motivated light direction throughout the camera move.\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.

Avg. provider uptime
—
last 30 days
Latency
—
last 30 days
Requests
8
30-day window
Successful inference trend

Activity

Seedance 2.5 video API usage activity

Only live Flatkey request data is shown here; a chart appears after enough traffic is collected.

Requests
8
30-day window
Latency
—
last 30 days
Uptime
—
last 30 days
Successful inference trendActivity

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.

Flatkey price

Price / second

Live catalog model
from $0.084 / second · 4s min
480p · Price / second
from $0.084 / second · 4s min
720p · Price / second
from $0.188 / second · 4s min
Try a prompt
Shared balance

Add credits

Add credits

Use the same Flatkey balance and API key across image, video, audio, and text models.

Model catalog
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.

CapabilitySeedance 2.0 (not re-audited)Seedance 2.5
Clip lengthNot verified in this audit4–30 seconds per request
Reference inputsNot verified in this auditUp to 50 total: 30 images, 10 videos, and 10 audio
Frame controlNot verified in this auditFirst-frame and last-frame roles are supported
AudioNot verified in this auditAudio generation can be enabled per request
Editing workflowNot verified in this auditReference-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.

Live cost estimate

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.

Available

Text to Video

Create a clip from a text prompt and supported output controls.

Model ID
seedance-2.5
Endpoint
/v1/videos
Available

Image to Video

Animate one or more image references while preserving the requested subject and composition.

Model ID
seedance-2.5
Endpoint
/v1/videos
Available

Reference to Video

Guide the result with the documented image, video, or audio reference inputs.

Model ID
seedance-2.5
Endpoint
/v1/videos
Not available on this route

Video Edit

Transform an existing clip when this route exposes video editing.

Model ID
seedance-2.5
Endpoint
/v1/videos
Not available on this route

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.

resolutionResolution
Accepted

480p · 720p

Default: 720p
ratioAspect ratio
Accepted

adaptive · 16:9 · 4:3 · 1:1 · 3:4 · 9:16

Default: adaptive
durationDuration
Accepted

4–30

Default: 5
generate_audioGenerate audio
Accepted

On · Off

Default: On
imageReference limit
Accepted

30 files

Endpoint: /v1/videos
videoReference limit
Accepted

10 files

Endpoint: /v1/videos
audioReference limit
Accepted

10 files

Endpoint: /v1/videos

From 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. 1

    Validate the model, prompt, references, and output settings.

  2. 2

    POST the request and retain the returned task ID.

  3. 3

    Poll task status or process the configured callback.

  4. 4

    Fetch the generated file from the content endpoint and store it before expiry.

Production checks

Parameter validation

Reject unsupported sizes, durations, ratios, formats, or reference counts before submitting.

Authentication and balance

Handle invalid keys, insufficient balance, rate limits, and account-group pricing separately.

Input or policy rejection

Surface the rejected prompt or asset clearly so the user can replace only the failing input.

Task failure or timeout

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.

Micro-drama and comic creators

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.

Create similar
Advertising and ecommerce teams

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.

Create similar
Film concept and production teams

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.

Create similar
Game art and animation teams

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.

Create similar
Creator and explainer channels

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.

Create similar
Music producers and visual artists

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.

Create similar

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.

Send the model id, a content[] array, and supported duration, resolution, ratio, and audio fields.
Save the task id returned by the request, then retrieve the generated file from the content endpoint when ready.
The adapter accepts up to 30 images, 10 videos, and 10 audio references, with 50 total.
Choose 480p or 720p, a supported ratio, 4–30 seconds, and whether to generate audio.
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-***"
Docs

FAQ

Seedance 2.5
API, pricing, and release-date questions

Pricing, compatibility, limits, and how your prompts and generated files are handled.

What is Seedance 2.5?
Seedance 2.5 is ByteDance's audio-video generation model for text-to-video and image-to-video requests, with reference media and optional audio controls.
How much does Seedance 2.5 cost?
Use the pricing section above for current Flatkey prices from our pricing API.
What can I use it for?
Use it for micro-drama and comic storyboards, product and UGC variants, film previsualization, game cinematics, creator clips, and market-research creative tests.
How do I use the model in my app?
POST to /v1/videos with the Seedance content[] format, retain the asynchronous task id, and fetch the result from /v1/videos/{task_id}/content.
Can I control output features?
Yes. Set 480p or 720p, 4–30 seconds, a supported ratio, generate_audio, and the documented reference/frame fields.
Is the Flatkey API OpenAI compatible?
Flatkey authentication and the shared catalog use the gateway pattern, while Seedance video requests use content[] and the asynchronous /v1/videos contract.
What limits apply?
A request can include up to 30 images, 10 videos, and 10 audio references, with 50 references total; account rate limits and availability can change.
What is the Seedance 2.5 release date?
The official ByteDance article was published on 2026-07-31; Flatkey's catalog lists released_at as 2026-08-04. These are different metadata fields, so neither date alone represents every launch.
Is Seedance 2.5 free?
No free or unlimited entitlement is promised on this page. Use the live Flatkey pricing data and your account limits before running jobs.