ToAPIs
home

Quick Answer

  • Seedance 2.5 supports Text-to-Video, Image-to-Video, R2V, and Video Edit in one workflow.
  • Use this model guide page to validate parameters with minimal request/response examples.
  • Stabilize prompts here first, then move to production API integration.

Key Parameters

  • model | string | required | seedance-2-5 | - | Model identifier. Use the fixed value `seedance-2-5`.
  • prompt | string | required | - | - | Main instruction describing the subject, action, scene, and style.
  • aspect_ratio | string | optional | adaptive | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive | Video aspect ratio. Defaults to `adaptive`; supports `16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive`.
  • duration | integer | optional | 30 | -1 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 20 | 30 | Output duration in seconds. Defaults to `30`; supports `-1 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 20 | 30`, where `-1` means auto.
  • resolution | string | optional | 720p | 480p | 720p | 1080p | Output resolution. Defaults to `720p`; supports `480p | 720p | 1080p`.

Common Errors

  • 400 invalid_request_error: trigger=Request payload misses required fields or has invalid field types.; fix=Validate model, mode, and input schema before request.; retry=Retry only after fixing payload; avoid blind retries.
  • 401 authentication_error: trigger=Missing Authorization header or invalid API key.; fix=Verify Bearer token format and API key scope.; retry=Retry after auth fix; rotate key if repeated failures continue.
  • 429 rate_limit_exceeded: trigger=Request rate, concurrency, or current quota hits upstream rate limiting.; fix=Apply exponential backoff first, then review request rate, concurrency, and quota usage.; retry=Use exponential backoff (e.g., 1s/2s/4s) with jitter; if it persists, reduce submission pressure.
  • 500 internal_error: trigger=Transient upstream error or internal processing failure.; fix=Capture request id and trigger retry workflow.; retry=Retry 2-3 times with short delays; escalate if persistent.
ByteDance Seed logo

Seedance 2.5

Commercial use

Generate, edit, and extend up to 30-second videos with image, video, and audio references.

Model Type:
Pricing: Seedance 2.5 from $5.4/1M total tokens
No video input $9/1M total tokens· With video input $5.4/1M total tokens

Input

FormJSON

Reference images

Describe subject, camera, scene, and style.215 / 1200

Advanced options

Example params

Output

PreviewJSON
View API DocsGet API Key

Generation takes some time. Please wait.You can leave this page. [ Task Logs ] lets you check the generated content directly.

Request preview

{
  "model": "seedance-2-5",
  "prompt": "A 30-second cinematic time-lapse story of an antique clock face, brass gears and weathered Roman numerals, slow push-in camera movement, warm golden light, subtle dust particles, precise second-level visual control.",
  "duration": 30,
  "size": "16:9",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "metadata": {},
  "generate_audio": true,
  "video_operation": "generate",
  "output_format": "mp4"
}

2.5

Model version

30s

Narrative target

Multi

Reference inputs

Live

Availability

Generated examples

Explore what Seedance 2.5 can create

Create with this model

Available now

30-second narrative planning

Multimodal references

Transparent pricing

Seedance 2.5 pricing reference

Seedance 2.5 is billed by usage.total_tokens, with separate rates depending on whether the request includes video input.

Top up credits

No video input

ToAPIs

$9

1M total tokens

With video input

ToAPIs

$5.4

1M total tokens

Final billing uses the completed task's usage.total_tokens. Per-second figures shown elsewhere are budget estimates only.

Why ToAPIs

Why use the Seedance 2.5 API on ToAPIs?

Build live workflows with prompts, reference assets, supported durations, documented resolutions, and account-based pricing.

Longer narrative planning

Prepare prompts, story beats, and review flows for coherent 30-second AI video drafts that need clear beginning, middle, and ending.

More reference inputs

Build workflows around multimodal references for characters, scenes, products, and visual style, then validate inputs directly in the Playground.

Scene-level control

Plan shot-level feedback, timing notes, and resolution checks for advertising, film, education, and product storytelling.

Prepare Seedance 2.5 API workflows in three steps

Use this page as a reference for Seedance 2.5 API payloads, multimodal limits, and generation workflows.

  1. 1

    Map the story

    Define subject, setting, action beats, camera direction, and intended 30-second pacing before you write the final prompt.

  2. 2

    Collect references

    Prepare characters, style frames, product visuals, and scene references for image-to-video and reference-to-video generation.

  3. 3

    Submit and verify

    Choose a supported duration and resolution, submit the request, then verify the generated video and final quote in Dashboard.

Best-fit Seedance 2.5 use cases

Advertising narratives

Prepare longer product stories, brand moments, and campaign concepts that need coherent motion.

Film and VFX ideation

Plan cinematic beats, transitions, and visual effects tests before committing to production renders.

Education and explainers

Draft structured scenes for educational clips that need clear pacing and visual continuity.

FAQ

Seedance 2.5 API FAQ

Is Seedance 2.5 available on ToAPIs now?

Yes. Seedance 2.5 is available in the Playground and through the documented video generation API.

How do I start using the Seedance 2.5 API?

Try Seedance 2.5 directly in the Playground, or use the video generation API docs to integrate it into your application.

Will Seedance 2.5 support 30-second AI videos?

Yes. Seedance 2.5 supports workflows up to 30 seconds. Choose a duration offered in the Playground or documented API parameters.

Will Seedance 2.5 support 4K video output?

Use the resolution options currently shown in the Playground and API docs. Production requests should not assume 4K unless it appears as a supported option there.

What capabilities should I plan around?

The official showcase highlights 30-second coherent output, more reference inputs, and second-level image control.

How is Seedance 2.5 different from Seedance 2.0?

Seedance 2.5 targets longer narrative output, richer multimodal references, and tighter scene control. Migrate existing Seedance 2.0 workflows only after validating 2.5 parameters and results.

Where can I find Seedance 2.5 API docs?

Use the API docs button on this page to view the video generation endpoint, supported parameters, and request fields.

How will Seedance 2.5 be billed?

Billing uses the completed task's usage.total_tokens. Requests with and without video input use different token rates; per-second prices are estimates only.

Seedance 2.5 API

Use Seedance 2.5 on ToAPIs

Try Seedance 2.5 in the Playground now, or use the API docs to integrate it into your video workflow.

Try nowView API Docs

Seedance 2.5 API is available on ToAPIs.

Use the 30-second generation workflow, multimodal limits, pricing status, and request fields for live calls.

Try Seedance 2.5