Seedance AI Video Generator
Seedance

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)OutputSettingsCredits per clip or image
Seedance 2.0seedance-2.0video480p, 720p · 4–15s5s 480p: 86 · 10s 480p: 172 · 5s 720p: 172 · 10s 720p: 344
Seedance 2.0 Fastseedance-2.0-fastvideo480p, 720p · 4–15s5s 480p: 72 · 10s 480p: 144 · 5s 720p: 144 · 10s 720p: 287
Seedance 2.0 Miniseedance-2-minivideo480p, 720p · 4–15s5s 480p: 43 · 10s 480p: 86 · 5s 720p: 86 · 10s 720p: 172
Seedance 2.5seedance-2.5video480p, 720p, 1080p · 4–30s5s 480p: 129 · 10s 480p: 258 · 5s 720p: 258 · 10s 720p: 515 · 5s 1080p: 644 · 10s 1080p: 1288
Nano Bananananobananaimage1K, 2K, 4K1K: 6 · 2K: 6 · 4K: 6
Nano Banana 2nanobanana2image1K, 2K, 4K1K: 11 · 2K: 16 · 4K: 21
Nano Banana Pronanobanana-proimage1K, 2K, 4K1K: 21 · 2K: 21 · 4K: 35
GPT Image 2gpt-image-2image1K, 2K, 4K1K: 9 · 2K: 15 · 4K: 26
Seedream 5 Liteseedream-5-liteimagebasic, highbasic: 6 · high: 6

Quick start

  1. Sign in, create a key below and tick “allow generation”. The secret is shown once.
  2. POST a prompt to /api/v1/generations with a unique Idempotency-Key.
  3. 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/tasks and /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.