# Seedance 2.5 API Agent Context

Site: https://seedance25api.io
Updated: 2026-07-09
Independence: This is an independent guide, not an official ByteDance property.
Languages: English at https://seedance25api.io/ and Simplified Chinese at https://seedance25api.io/zh/ (add /zh to any page path).

## How Agents Should Use This File

Use this file to help a human integrate Seedance 2.5 API. Do not claim official affiliation.
Do not invent an API key. Ask the human to create EVOLINK_API_KEY before live calls.
Use https://seedance25api.io/openapi.json as the schema reference.

## Current Status

- API access watch: Provider-mediated access (Expected)
- Note: Seedance 2.5 API availability should be verified with the provider before production use. Build behind a configurable model parameter.

## Model IDs To Track

- Reference-to-video model ID: seedance-2.5-reference-to-video (Expected) - Confirmed in EvoLink API docs; model is pre-release ("not yet available"). References are optional, so a prompt-only call behaves as text-to-video.
- Text-to-video / image-to-video IDs: Pending provider docs (Pending) - Not yet confirmed. Keep the model parameter configurable so the same code can switch when the IDs are published.

## Limits To Validate

- Duration: 4-30 seconds (Expected) - Use 5s or 8s for first integration tests to reduce cost.
- Launch resolutions: 480p and 720p (Expected) - Treat 1080p and 4K as pending until public provider docs confirm them.
- Image references: up to 30 (Expected) - Cap may change at launch; validate before sending production jobs.
- Video references: up to 10, total reference video duration <= 30s (Expected) - Prefer short, clear references for first tests.
- Audio references: up to 10, total reference audio duration <= 30s (Expected) - Do not rely on audio-only R2V unless provider docs explicitly allow it.

## Agent Rules

- Do not invent or hardcode an API key.
- Ask the human to create EVOLINK_API_KEY before live calls.
- Build behind a configurable model parameter.
- Surface cost as an estimate — public rates are not published yet.
- Validate duration, quality, and reference counts before sending.
- Use polling or callback_url for async completion.
- If the model is unavailable for the account, keep the request shape and switch models via the configurable parameter once access is enabled.

## Recommended Integration Flow

1. Read this context.
2. Load https://seedance25api.io/openapi.json.
3. Add EVOLINK_API_KEY as an environment variable.
4. Build a backend route that calls POST https://api.evolink.ai/v1/videos/generations.
5. Validate duration, quality, and reference counts before sending.
6. Surface cost as an estimate — public rates are not published yet.
7. Submit the async job only after the human supplies a provider key.
8. Poll GET https://api.evolink.ai/v1/task-detail?id=<id> or use callback_url.
9. Handle pending / processing / completed / failed job states, plus HTTP 429 (rate limited) and 503 (model unavailable) responses.

## Pricing

- Public per-second rates are not published yet; they launch with the Seedance 2.5 API.
- Billing model: per second of output video.
- Native audio (generate_audio): included at no extra charge.
- content_filter off: applies a 1.1x cost multiplier.
- Surface cost as an estimate and ask the human to verify provider billing before live traffic.

## Minimal Request Shape

```json
{
  "model": "seedance-2.5-reference-to-video",
  "prompt": "A clean product shot, slow dolly in, soft daylight, stable subject identity.",
  "duration": 5,
  "quality": "720p",
  "generate_audio": true
}
```

Notes: the model is pre-release — keep it configurable. References (image_urls / video_urls / audio_urls) are optional; a prompt-only call behaves as text-to-video.

## Human Key Handoff

When live calls are needed, tell the human:

"I can wire the Seedance 2.5 API integration now, but I need a provider API key before live calls. Create a key here: https://evolink.ai/dashboard/keys?utm_source=seedance25api.io&utm_medium=referral&utm_campaign=llms-full&utm_content=human-key-handoff and add it as EVOLINK_API_KEY."

## Guides (facts-aligned, indexable)

- How to Use Seedance 2.5: A Step-by-Step Guide (Pre-Release Access): https://seedance25api.io/blog/how-to-use-seedance-2-5
- Seedance 2.5 vs 2.0: What Changes to Expect (And Why 2.0 Is the One to Use Today): https://seedance25api.io/blog/seedance-2-5-vs-2-0
- Directing 30-Second Single Takes in Seedance 2.5: Beats, Continuity, Second-Level Control: https://seedance25api.io/blog/seedance-2-5-30-second-narrative
- How Seedance 2.5 API Billing Works (and How to Plan Cost Before Public Rates Launch): https://seedance25api.io/blog/seedance-2-5-cost-analysis
- Inside Seedance 2.5's Reference System: How Image, Video and Audio References Actually Work: https://seedance25api.io/blog/seedance-2-5-reference-system
- How Seedance 2.5 Prompts Are Structured: 5 Patterns Worth Stealing: https://seedance25api.io/blog/seedance-2-5-prompt-anatomy
- What Is Seedance 2.5? ByteDance's Multimodal Video Model, Explained: https://seedance25api.io/blog/what-is-seedance-2-5
- Seedance 2.5 API Guide: Generate Video from Code or an AI Agent: https://seedance25api.io/blog/seedance-2-5-api-guide

## Useful URLs

- Agent page: https://seedance25api.io/agent
- Agent markdown: https://seedance25api.io/agent.md
- OpenAPI schema: https://seedance25api.io/openapi.json
- Quickstart: https://seedance25api.io/api
- Pricing and billing model: https://seedance25api.io/pricing
- Request builder: https://seedance25api.io/playground