Errors

Klint returns branded errors without leaking upstream provider details.

Error format

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds.",
    "type": "rate_limit_error"
  }
}

Common codes

Code HTTP Description
invalid_api_key 401 Key missing or invalid
insufficient_tokens 402 Wallet balance exhausted
rate_limit_exceeded 429 Too many requests
model_not_found 404 Unknown model ID
upstream_error 502 Provider temporarily unavailable