Docs / Runtime

Error codes

Error bodies match the official structure, with a request id added.

Status code

Meaning & handling

401

Invalid or disabled API key — check the Bearer prefix.

402

Insufficient balance — top up, or convert referral commission into usable credit.

403

This key is not allowed to use this model.

429

Rate limit hit — retry with backoff.

502

All upstream channels failed — retry later and include the request id.

JSON

{
  "error": {
    "message": "insufficient balance",
    "type": "insufficient_quota",
    "code": 402,
    "request_id": "req_8f2ac41d9b"
  }
}