# Seedance API

> REST API for Seedance AI video and Seedream 5 Pro image generation. Bearer token auth, stable public model aliases, and credits per 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
- Seedream 5 Pro Image API: https://seedanceapi.org/docs/images
- 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

## Image API — Seedream 5 Pro

- Base URL: https://seedanceapi.org/v1/images
- POST /v1/images/generations — create a text-to-image or reference-image editing task
- GET /v1/images/generations/:task_id — get a task by task ID
- Model: `seedream-5-pro`
- Resolution: `1k` (9 credits) or `2k` (18 credits)
- Reference images: 0–10 public HTTPS URLs; from the second image, add 0.8 credits each
- Status values: `IN_PROGRESS`, `SUCCESS`, `FAILED`

Full image API docs: https://seedanceapi.org/docs/images

## 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 video integrations; use /docs/images for Seedream 5 Pro image generation.