INSUFFICIENT_CREDITS

HTTP status: 402

What it means

The credit balance cannot cover this render's estimated cost.

Why it happens

• The render's estimated credit cost exceeds your remaining balance. Everything draws from one balance: 10 credits per weighted render-minute (draft ×0.5, 60 fps ×2, 4K ×2) plus 1 credit per AI image generation — cache hits are free.

How to fix it

• Check GET /v1/usage for your remaining plan and purchased credits.
• Render drafts while iterating ("draft": true costs half).
• Subscribe or upgrade at https://automotion.dev/pricing, or buy a credit top-up from the dashboard (subscribers only). The balance is a hard stop — there is no overage billing.

Example

Every non-2xx response uses the same envelope; path (when present) is the exact JSON path of the offending field, and requestId identifies the request in support conversations:

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits: this render needs an estimated 30 credit(s) but 12 remain. Subscribe or buy a top-up at https://automotion.dev/pricing to keep rendering.",
    "docsUrl": "https://automotion.dev/docs/errors/insufficient_credits"
  },
  "requestId": "req_0123456789abcdef0123456789abcdef"
}

See the error index for the full catalog and the API overview for envelope semantics.