Authentication
Authenticate Seedance 3.0 API requests with a bearer API key, and manage keys from your account settings.
Every request except GET /models needs an API key.
Create a key
- Sign in and open Settings → API Keys.
- Click Create API Key and give it a name you'll recognise (for example
production-backend). - Copy the
sk-...value and store it in an environment variable or secret manager.
You can create several keys — one per app or environment — and delete any key at any time. A deleted key stops working immediately.
Send the key
Pass the key in the Authorization header:
Authorization: Bearer sk-your-api-keyX-API-Key: sk-your-api-key is accepted as an alternative for clients that cannot set Authorization.
export SEEDANCE_API_KEY="sk-your-api-key"
curl https://seedance3ai.video/api/v1/credits \
-H "Authorization: Bearer $SEEDANCE_API_KEY"What a key can do
A key acts as your account for the API only:
- It spends your credits when it starts a generation.
- It can read the generations it — or you on the website — created.
- It cannot sign in to the website, change account settings or make payments.
Keep keys server-side
Never put an API key in browser JavaScript, a mobile app bundle or a public repository. Anyone holding the key can spend your credits. If a key leaks, delete it on the API Keys page and create a new one.
Authentication errors
| Status | error.type | Meaning |
|---|---|---|
401 | authentication_error | Missing, malformed, deleted or unknown key |
403 | permission_error | The account that owns the key is disabled |