Seedance 2.5 API guide

Seedance 2.5 API for AI video generation

Developers searching for a Seedance 2.5 API can start on Seedance API v2 today. This page captures Seedance 2.5 keyword intent, explains the REST workflow, and routes you to the current public endpoints without overclaiming unsupported model specs.

Clip length
5-15s

5-15 second jobs

Current stack
v2

Seedance API v2

Inputs
T2V + I2V

Prompt or reference images

Interface
REST

JSON over HTTPS

Starter request

Start with the current Seedance v2 model path

seedance-2.0
curl -X POST 'https://seedanceapi.org/v2/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cinematic product reveal with smooth dolly-in camera motion",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

Public Seedance API v2 exposes seedance-2.0, seedance-2.0-fast, and seedance-2-mini. Use this Seedance 2.5 API planning page to design your integration while next-version demand grows.

Why developers search for a Seedance 2.5 API

Seedance 2.5 API is a high-intent keyword for teams planning the next Seedance video stack. The practical path today is Seedance API v2 with async jobs, clear billing, and production-friendly status polling.

Capture next-version demand

Seedance 2.5 API pages help you rank for future model interest while routing engineers into a working REST integration on the current public stack.

Simple API-key access

Authenticate with Bearer tokens, create jobs with POST /v2/generate, and poll GET /v2/status using the same API pattern as the broader Seedance 2.0 API.

Production-friendly boundaries

Async task ids, explicit durations, and structured error responses make Seedance 2.5 API planning easier to fit into queues, moderation, and billing systems.

Seedance 2.5 API capabilities to plan around

This page focuses on the Seedance 2.5 API workflow developers expect: REST generation, reference-image motion, short cinematic clips, and repeatable async polling.

REST video generation

Use POST /v2/generate to create Seedance 2.5 style video jobs from server-side code with JSON payloads and Bearer authentication.

Text-to-video clips

Send a structured prompt, aspect ratio, duration, and model hint to generate short video assets for apps, social surfaces, and creative testing.

Image-to-video motion

Provide one to four HTTPS image URLs when your Seedance 2.5 API workflow needs reference-image animation or product motion tests.

Multiple model paths

Plan around seedance-2.0 for quality, seedance-2.0-fast for speed, or seedance-2-mini for compact preview jobs on the same v2 base.

Async status polling

Every request returns a task id, so your app can poll status, update UI state, and fetch the final video URL when the job succeeds.

Shared v2 foundation

Seedance 2.5 API planning uses the same v2 authentication, billing, logs, and response shape as the current Seedance 2.0 API.

How to use a Seedance 2.5 API workflow

Start with the existing Seedance API v2 endpoints and keep claims practical while public Seedance 2.5 documentation continues to evolve.

1

Create an API key

Sign in, open the API Keys page, and copy a key for server-side use. Keep the key out of browser code and public repositories.

2

Submit a generation job

Call POST /v2/generate with model seedance-2.0 or seedance-2.0-fast, a focused prompt, duration, and the aspect ratio your product needs.

3

Poll and deliver

Use GET /v2/status with the returned task_id. When status is SUCCESS, read data.response[0] and display or store the video URL.

Seedance 2.5 API request pattern

The integration flow stays intentionally small: authenticate, create a generation task, then poll for completion.

POST /v2/generate

Creates a Seedance video generation task. Use text prompts for text-to-video, images for image-to-video, or reference inputs when your workflow needs them.

GET /v2/status

Returns processing state, failure details, or the final response array with the generated video URL.

Optional callback URL

For async systems, include a public callback_url when supported by your integration. Do not use localhost URLs.

Recommended Seedance 2.5 API parameters

ParameterRecommended value
modelUse seedance-2.0, seedance-2.0-fast, or seedance-2-mini on the current public stack.
promptKeep it focused and specific; max 2000 characters.
durationUse 5, 10, or 15 seconds on standard v2 paths.
resolutionUse 480p or 720p where supported by the selected model path.
aspect_ratioUse 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, or adaptive for text-to-video.
imagesUse one to four HTTPS image URLs for image-to-video.
reference_video_urlsOptional reference video URLs when your workflow supports video-guided generation.
reference_audio_urlsOptional reference audio URLs when your workflow supports audio-guided generation.
callback_urlOptional public webhook URL for async notifications.

For a full parameter reference, use the Seedance 2.0 API v2 documentation. This page narrows the same API to Seedance 2.5 planning intent.

Best Seedance 2.5 API use cases

Seedance 2.5 API workflows are best when teams need cinematic short-form video inside an existing product or automation pipeline.

Product video automation

Generate compact clips for ecommerce, app onboarding, and campaign previews from structured prompts or product stills.

Creative iteration tools

Let users test many prompt variants quickly, compare results, and promote the best concept to production rendering.

Storyboard motion tests

Convert script beats or keyframes into short Seedance 2.5 motion tests before editing, review, or client approval.

High-volume API pipelines

Use async jobs, queues, and status polling for batch previews, content pipelines, and apps that need predictable throughput.

Production integration notes

A Seedance 2.5 API workflow still needs the same operational care as any production video API integration.

Run calls from your backend

Store API keys on your server, call Seedance API from backend code, and expose only your own safe endpoints to clients.

Queue and retry jobs

Use a queue to manage concurrency, retry transient failures, and keep the user interface responsive while video jobs process.

Track credits and status

Monitor credit usage, task status, and error responses so your Seedance 2.5 API workflow remains predictable as volume grows.

Seedance 2.5 API planning vs current public baseline

Public official material currently centers on Seedance 2.0. Use this table to plan Seedance 2.5 API messaging without unsupported claims.

Keyword intent is forward-looking

Seedance 2.5 API searches often come from teams preparing the next Seedance integration before public docs catch up.

Current stack is already usable

Seedance API v2 gives you working REST endpoints, model selection, and billing today while Seedance 2.5 demand grows.

Same integration shape

Authentication, billing, status polling, and response parsing stay consistent across current v2 usage and Seedance 2.5 planning pages.

TopicCurrent public baselineSeedance 2.5 planning angle
Public documentationSeedance 2.0 has official public model pages and v2 docs.Seedance 2.5 API pages should avoid unsupported specs and focus on workflow planning.
Generation workflowPOST /v2/generate plus GET /v2/status on Seedance API v2.Emphasize async jobs, prompt design, and repeatable review loops.
Model selectionseedance-2.0, seedance-2.0-fast, seedance-2-mini.Plan for future model naming while integrating on the current stack.
SEO intentDevelopers already understand Seedance as an AI video API family.Seedance 2.5 API pages capture next-version demand and route to working endpoints.

Seedance 2.5 API FAQ

Answers for developers evaluating a Seedance 2.5 API style integration.

Is there a separate Seedance 2.5 API endpoint?

Public Seedance API v2 is the current integration path. Use POST /v2/generate and GET /v2/status while Seedance 2.5 documentation continues to evolve.

What is Seedance 2.5 API best for?

Seedance 2.5 API workflows are best for short cinematic clips, product motion tests, social previews, and high-volume prompt iteration inside your own app.

Can I use image-to-video with a Seedance 2.5 API workflow?

Yes. Send one to four HTTPS image URLs in the images field and keep the prompt focused on the motion you want.

Which model should I start with?

Start with seedance-2.0-fast for speed, seedance-2.0 for richer output, or seedance-2-mini for compact preview jobs on the same v2 base.

Which aspect ratios are supported?

For text-to-video, v2 accepts 16:9, 9:16, 4:3, 3:4, 1:1, 21:9, and adaptive. Choose the ratio that matches your placement.

How do I authenticate requests?

Pass Authorization: Bearer YOUR_API_KEY on every request. Keep that key on your backend and never expose it in client-side code.

How do I get the final video URL?

Poll GET /v2/status with task_id. When status is SUCCESS, read the first video URL from data.response[0].

Does this work with any programming language?

Yes. The Seedance 2.5 API workflow uses standard HTTPS and JSON, so it works with cURL, Python, Node.js, Go, Java, and other HTTP clients.

Should I call the API directly from the browser?

No. Use your backend or BFF to protect API keys, validate prompts, enforce rate limits, and handle retries.

How is billing handled?

Seedance API uses credits. Cost depends on the model and duration, so shorter preview jobs are easier to forecast.

How is this different from the Seedance 2.0 Mini API page?

The Mini API page focuses on seedance-2-mini and compact preview jobs. This Seedance 2.5 API page captures broader next-version intent on the same v2 stack.

Where can I find the complete API docs?

Open the Seedance 2.0 API v2 documentation for the full request schema, response examples, pricing tables, and error codes.

Start your Seedance 2.5 API integration

Create an API key, send your first v2 generation job, and plug AI video generation into your product today.