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

  1. Sign in and open Settings → API Keys.
  2. Click Create API Key and give it a name you'll recognise (for example production-backend).
  3. 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-key

X-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

Statuserror.typeMeaning
401authentication_errorMissing, malformed, deleted or unknown key
403permission_errorThe account that owns the key is disabled