Seedance Public API
Private Beta documentation for Seedance video and image generation APIs.
Private Beta — Access is manually approved. API generation uses the same credit balance, pricing rules, task records, and failure-refund behavior as the PC product.
Entry points
- Documentation:
https://seedance2video.io/docs/api - Account entry:
/settings/public-api - Base URL:
https://api.seedance2video.io/v1 - OpenAPI:
https://api.seedance2video.io/v1/openapi.json
Use the OpenAPI URL with Postman, Insomnia, Bruno, or a server-side client generator. v1 does not enable browser CORS; never put a live key in frontend JavaScript.
Phase-one endpoints
| Capability | Endpoint |
|---|---|
| List key-enabled models | GET /models |
| Create a video | POST /videos |
| Create an image | POST /images |
| Poll a generation | GET /generations/{id} |
| Read the PC credit balance | GET /credits/balance |
| Download OpenAPI | GET /openapi.json |
Uploads, Webhooks, cancellation, usage listing, self-service keys, test keys, and a separate API wallet are intentionally unavailable in phase one.
Contract
- Authenticate with
Authorization: Bearer sd_live_.... - Add a stable
Idempotency-Keyto every create request. - Generation is asynchronous; poll the returned
status_url. - Completed URLs are returned in
output.urls, withoutput.video_urloroutput.image_urlsas convenient typed fields. - Media inputs must be public HTTPS URLs on storage hosts approved for your integration. Base64,
data:URLs, localhost, IP literals, and arbitrary remote hosts are rejected. - Provider names, Provider task IDs, raw Provider responses, and internal model IDs are never returned.
Models
The allowlist is seedance-2.0-pro, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, gpt-image-2, nano-banana-2, and nano-banana-pro.
No Veo or Lite model is exposed.
Real-person mode
Real-person generation requires manual Key approval. It is limited to the three Seedance models in image-to-video or multimodal-to-video. Set parameters.real_person_mode: true and provide compliance.rights_confirmed: true plus a customer audit reference in compliance.consent_reference. Safety controls remain server-owned.
Start with the Quickstart, then review Authentication, Models & Pricing, Async Generations, Errors & Idempotency, and n8n.