API reference
Get available credits
Returns the account's total credits, the credits reserved for active video tasks, and the credits available for a new task.
GET
/v1/creditsAuthorizationBearer <token>
Create a Seeddance API key in Settings. Send it only from a trusted server.
In: header
Response Body
curl "https://seeddance.io/v1/credits" \ -H "Authorization: Bearer sk_sd_example"{
"total": 1000,
"reserved": 50,
"available": 950
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is invalid, expired, or revoked.",
"param": null,
"request_id": "req_2YgM6pg5oM2WkKpQ"
}
}{
"error": {
"code": "rate_limit_exceeded",
"message": "API rate limit exceeded. Try again later.",
"param": null,
"request_id": "req_2YgM6pg5oM2WkKpQ"
}
}{
"error": {
"code": "internal_error",
"message": "The request could not be completed.",
"param": null,
"request_id": "req_2YgM6pg5oM2WkKpQ"
}
}Get a video task GET
Returns a task created by the authenticated account. While the status is `pending` or `processing`, poll this endpoint with backoff. A completed task includes a durable Seeddance video URL.
Errors and retries
Learn which errors are safe to retry and how to avoid duplicate video tasks.