Errors

Every failure is RFC 9457 application/problem+json, including the ones raised before a controller runs. You will never get an HTML error page.

{
  "type": "…/errors/insufficient_tokens",
  "code": "insufficient_tokens",
  "status": 402,
  "title": "Not enough tokens",
  "detail": "This run costs 750 tokens.",
  "hint": "Top up with POST /v1/billing/topup_link, then retry.",
  "retryable": false,
  "required_tokens": 750,
  "available_tokens": 120,
  "docs_url": "…/errors/insufficient_tokens",
  "request_id": "req_01J…"
}