# Seedance 2.5 API Agent Context

Site: https://seedance25api.io
Updated: 2026-08-07
Independence: This is an independent guide, not an official ByteDance property.
Languages: English at https://seedance25api.io/, Simplified Chinese at https://seedance25api.io/zh/, Japanese at https://seedance25api.io/ja/, and Korean at https://seedance25api.io/ko/. Add the matching locale prefix to a translated 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 an independent integration aid. EvoLink provider documentation and console remain authoritative for live fields, prices, and account limits.

## Current Status

- Official developer API live (Confirmed) — The official developer API is live at this page publication, and EvoLink launches its integrated route on the same publication date.
- EvoLink route status: Live on EvoLink · API key access available (Confirmed)
- Note: The upstream official API and EvoLink integration are live for the August 7 publication. Use the three workflow-specific EvoLink model IDs and verify the current price shown in the EvoLink console before production traffic.

## Model IDs To Track

- Text to video: seedance-2.5-text-to-video (Confirmed) - Live EvoLink model ID for prompt-only text-to-video requests.
- Image to video: seedance-2.5-image-to-video (Confirmed) - Live EvoLink model ID for first-frame or first/last-frame image-to-video requests.
- Reference to video: seedance-2.5-reference-to-video (Confirmed) - Live EvoLink model ID for multimodal reference-to-video, editing, and extension workflows.

## Live Launch Limits

- Duration: 4–30 seconds (Confirmed) - EvoLink launch documentation supports 4–30 seconds; choose a duration allowed by the selected workflow.
- Launch resolutions: 480p and 720p (Confirmed) - EvoLink launch tiers are 480p and 720p. Product-side 4K showcases are not an EvoLink API tier.
- Reference inputs: 30 images / 10 videos / 10 audio files for R2V (Confirmed) - Keep the per-type split. Do not rewrite it as an arbitrary pool of 50 files or apply it to every mode.

## Agent Rules

- Do not invent or hardcode an API key.
- The official API and the EvoLink route are live for this publication; keep their sources and pricing distinct.
- Use the workflow-specific Seedance 2.5 model ID and keep Seedance 2.0 only as a rollback.
- Ask the human to create EVOLINK_API_KEY before a live call.
- Build behind a configurable model parameter.
- Do not present upstream provider token rates as EvoLink route prices.
- Use 4–30 seconds, 480p/720p, and the documented per-type reference limits; never advertise 4K as an API tier.
- Poll GET /v1/tasks/{task_id} for the EvoLink asynchronous task flow.
- Read the current EvoLink console price before production traffic; do not present upstream official pricing as an EvoLink quote.

## Recommended Integration Flow

1. Read this context.
2. Load https://seedance25api.io/openapi.json for the live request and polling shape.
3. Add EVOLINK_API_KEY as an environment variable.
4. Build a provider adapter around the current EvoLink asynchronous video pattern.
5. Choose the matching live model ID: text-to-video, image-to-video, or reference-to-video.
6. Submit POST https://api.evolink.ai/v1/videos/generations after the human supplies a provider key.
7. Poll GET https://api.evolink.ai/v1/tasks/{task_id} until completion.
8. Handle pending / processing / completed / failed task states and the documented HTTP error envelope.
9. Keep Seedance 2.0 configured only as an explicit rollback.

## Pricing

- The EvoLink route is live; read its current price from the EvoLink console before scaled calls.
- Do not copy Seedance 2.0 or upstream official billing rules into a 2.5 estimate as if they were EvoLink route facts.
- Keep the route price configurable and reconcile a short test against actual usage.

## Live 2.5 Text-to-Video Shape

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

Notes: this example uses the live text-to-video ID. Switch to the image-to-video or reference-to-video ID only with its matching input fields. Keep Seedance 2.0 as rollback.

## Human Key Handoff

When live calls are needed, tell the human:

"The official Seedance 2.5 API and EvoLink route are live. Choose the workflow you want, create an API key here: https://evolink.ai/dashboard/keys?utm_source=seedance25api.io&utm_medium=referral&utm_campaign=llms-full&utm_content=human-key-handoff, then add it as EVOLINK_API_KEY before I run a short first test."

## Guides (facts-aligned, indexable)

- Seedance 2.5 Evaluation Plan for Production: https://seedance25api.io/blog/seedance-2-5-production-evaluation
- Seedance 2.5 Developer Use Cases: What 12 Demos Reveal: https://seedance25api.io/blog/seedance-2-5-developer-use-cases
- How to Use Seedance 2.5: Step-by-Step API & EvoLink Guide: https://seedance25api.io/blog/how-to-use-seedance-2-5
- Directing 30-Second Single Takes in Seedance 2.5: https://seedance25api.io/blog/seedance-2-5-30-second-narrative
- Seedance 2.5 API Cost: Official vs EvoLink Route Billing: https://seedance25api.io/blog/seedance-2-5-cost-analysis
- Inside Seedance 2.5's Reference System: Image, Video, Audio: https://seedance25api.io/blog/seedance-2-5-reference-system
- What Is Seedance 2.5? ByteDance's Multimodal Video Model: https://seedance25api.io/blog/what-is-seedance-2-5
- How Seedance 2.5 Prompts Are Structured: 5 Patterns to Steal: https://seedance25api.io/blog/seedance-2-5-prompt-anatomy
- Seedance 2.5 vs 2.0: Which Workloads Move, Wait, or Stay?: https://seedance25api.io/blog/seedance-2-5-vs-2-0
- Seedance 2.5 EvoLink API Guide: Live Integration Checklist: 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