# Seedance API

> REST API for ByteDance Seedance AI video generation. Two API versions: v1 (Seedance 1.5 Pro) and v2 (Seedance 2.0 / 2.0 Fast / 2 Mini). Bearer token auth; credits per successful generation. 1 USD = 100 credits.

## Core Links

- Documentation hub: https://seedanceapi.org/docs
- Seedance 2.0 API (v2): https://seedanceapi.org/docs/v2
- Seedance 2.5 API guide: https://seedanceapi.org/seedance-2-5
- Seedance 2.0 Mini API guide: https://seedanceapi.org/seedance-2-0-mini-api
- Seedance 1.5 Pro API (v1): https://seedanceapi.org/docs/v1
- Pricing / top up credits: https://seedanceapi.org/pricing
- API keys (dashboard): https://seedanceapi.org/dashboard/api-keys
- API request logs: https://seedanceapi.org/dashboard/logs
- Sitemap: https://seedanceapi.org/sitemap.xml

## Authentication

- Header: `Authorization: Bearer YOUR_API_KEY`
- Create and manage keys at https://seedanceapi.org/dashboard/api-keys

## API v2 — Seedance 2.0, 2.0 Fast & 2 Mini

- Base URL: https://seedanceapi.org/v2
- POST /v2/generate — create a text-to-video or image-to-video task
- GET /v2/status?task_id=... — poll task until SUCCESS or FAILED
- Models: `seedance-2.0` (default), `seedance-2.0-fast`, `seedance-2-mini`
- Duration: 5, 10, or 15 seconds
- Text-to-video: `prompt` + `aspect_ratio` (16:9, 9:16, 4:3, 3:4)
- Image-to-video: `prompt` + `images` (1–4 http/https URLs)
- Optional: `callback_url`, `public`

### v2 credits (per task)

Seedance 2.0 (standard): 5s = 240 credits; 10s = 480 credits; 15s = 720 credits
Seedance 2.0 Fast: 5s = 160 credits; 10s = 320 credits; 15s = 480 credits

Full v2 docs: https://seedanceapi.org/docs/v2

## API v1 — Seedance 1.5 Pro

- Base URL: https://seedanceapi.org/v1
- POST /v1/generate — create a generation task
- GET /v1/status?task_id=... — poll task status
- Resolutions: 480p and 720p; durations 4s, 8s, 12s; optional audio

### v1 credits (examples)

480p without audio: 4s = 8; 8s = 14; 12s = 19 credits
480p with audio: 4s = 14; 8s = 28; 12s = 38 credits
720p without audio: 4s = 14; 8s = 28; 12s = 42 credits
720p with audio: 4s = 28; 8s = 56; 12s = 84 credits

Full v1 docs: https://seedanceapi.org/docs/v1

## Integration Notes

- Poll GET /status until `status` is SUCCESS (video URLs in `response`) or FAILED (`error_message`).
- HTTP 402 means insufficient credits — top up at /pricing.
- Prefer /docs/v2 for new Seedance 2.0 integrations; keep /docs/v1 for existing 1.5 Pro clients.