Developer API

Errors and Billing

Most long-running jobs return queued ids immediately. Billing and budget responses include credit fields so clients can show clear user-facing decisions.

#HTTP errors

Clients should branch on status code and error code, then show user-facing billing or retry decisions.

CodeDescription

401

Missing, expired, or invalid bearer token.

402

Insufficient credits, budget exceeded, or premium approval required.

403

The API key is valid but does not include the scope required for the endpoint.

404

Requested generation, repurpose task, user, or account was not found.

409

The device code has already been used or the request conflicts with current state.

429

The API key or organization exceeded the current request limit.

500

Queue, database, provider, or internal processing failure.