Errors use the familiar envelope:
{
"error": {
"type": "insufficient_credit",
"message": "The funding project's budget is exhausted.",
"code": 402
}
}Codes to handle#
| HTTP | Type | Meaning |
|---|---|---|
401 |
invalid_key |
Missing, malformed or revoked credential |
402 |
insufficient_credit |
Wallet or budget can't fund the call |
403 |
not_entitled |
No active subscription covers this product |
404 |
unknown_model |
Product id doesn't exist or isn't visible to you |
429 |
rate_limited |
Slow down; honour Retry-After |
5xx |
upstream_error |
Grid or product backend fault — safe to retry idempotent calls |