Seedance API
Call Seedance 2.5 and Seedance 2.0 from your own app, script or AI agent. Send a text prompt, get a video back, and pay with the same credits you use in the studio. Create a key below, or connect through MCP.
Models and credit pricing
Live from the API catalog. Model access follows your plan; Seedance 2.5 needs Creator or Studio.
| Model (id) | Output | Settings | Credits per clip or image |
|---|---|---|---|
| Seedance 2.0seedance-2.0 | video | 480p, 720p · 4–15s | 5s 480p: 86 · 10s 480p: 172 · 5s 720p: 172 · 10s 720p: 344 |
| Seedance 2.0 Fastseedance-2.0-fast | video | 480p, 720p · 4–15s | 5s 480p: 72 · 10s 480p: 144 · 5s 720p: 144 · 10s 720p: 287 |
| Seedance 2.0 Miniseedance-2-mini | video | 480p, 720p · 4–15s | 5s 480p: 43 · 10s 480p: 86 · 5s 720p: 86 · 10s 720p: 172 |
| Seedance 2.5seedance-2.5 | video | 480p, 720p, 1080p · 4–30s | 5s 480p: 129 · 10s 480p: 258 · 5s 720p: 258 · 10s 720p: 515 · 5s 1080p: 644 · 10s 1080p: 1288 |
| Nano Bananananobanana | image | 1K, 2K, 4K | 1K: 6 · 2K: 6 · 4K: 6 |
| Nano Banana 2nanobanana2 | image | 1K, 2K, 4K | 1K: 11 · 2K: 16 · 4K: 21 |
| Nano Banana Pronanobanana-pro | image | 1K, 2K, 4K | 1K: 21 · 2K: 21 · 4K: 35 |
| GPT Image 2gpt-image-2 | image | 1K, 2K, 4K | 1K: 9 · 2K: 15 · 4K: 26 |
| Seedream 5 Liteseedream-5-lite | image | basic, high | basic: 6 · high: 6 |
Quick start
- Sign in, create a key below and tick “allow generation”. The secret is shown once.
- POST a prompt to
/api/v1/generationswith a unique Idempotency-Key. - Poll
/api/v1/tasks/{id}until the status is completed, then download videoUrl.
curl 'https://www.seedancev2ai.com/api/v1/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: my-first-clip-001' \
-d '{"model":"seedance-2.5","prompt":"A paper boat drifting down a rainy street, slow push-in","ratio":"16:9","resolution":"720p","duration":5}'Endpoints
GET /api/v1/models: models, allowed ratios, resolutions, durations and credits.GET /api/v1/balance: credit balance and the key's daily limit.POST /api/v1/generations: start one video or image from a text prompt.GET /api/v1/tasksand/api/v1/tasks/{id}: your latest 20 tasks, or one task.
Use Seedance through MCP
Add the server to an MCP client that supports Streamable HTTP and a custom Authorization header.
{
"mcpServers": {
"seedance": {
"url": "https://www.seedancev2ai.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Seedance API FAQ
Which models can I call through the Seedance API?
Seedance 2.5, Seedance 2.0, Seedance 2.0 Fast and Seedance 2.0 Mini for video, plus Nano Banana, GPT Image 2 and Seedream 5 Lite for images. GET /api/v1/models returns the current list with every supported setting.
How much does a Seedance API call cost?
API calls use the same credits as the web studio, taken from your account balance. The cost depends on the model, resolution and duration; the table above and GET /api/v1/models list the exact credits for each combination.
Can I send reference images or videos?
Not in this API version. Requests are text prompt only. Image-to-video, first and last frames and multimodal references are available in the web studio.
How do I get the result?
POST /api/v1/generations returns task IDs. Poll GET /api/v1/tasks/{id}; videoUrl or imageUrl is filled in once the task is completed.
What happens if a request times out and I retry?
Send the same Idempotency-Key with the retry. The API returns the original result instead of starting and charging a second generation.
Are there rate limits?
Each key allows 60 requests per minute, and each key has its own daily credit limit that you set when you create it. Keys expire after 90 days and can be revoked at any time.
Can I use the Seedance API from an MCP client?
Yes, from MCP clients that support Streamable HTTP and a custom Authorization header: point them at /api/mcp with your API key as a Bearer token. Browser OAuth sign-in is not supported yet.