Skip to main content
All API errors follow the OpenAI-compatible error format. The code field contains one of the 18 machine-readable error codes listed below.
Error CodeHTTP StatusDescription
budget_exceeded402Request blocked by budget spending limit
capability_mismatch400Model lacks requested capability
forbidden403Access denied for this resource
gateway_unavailable502Cannot reach backend gateway
insufficient_quota402Insufficient credits to complete request
internal_error500Unexpected internal error
invalid_api_key401Invalid or missing API key
invalid_request400Malformed or invalid request
missing_required_parameter400Required parameter not provided
model_not_found404Requested model not found in catalog
no_providers_available503No providers available for requested model
not_found404Resource not found
provider_auth_error401BYOK provider key authentication failed
provider_error502*Upstream provider error (status varies by provider failure)
rate_limit_exceeded429Request rate limit exceeded
routing_constraint_unsatisfiable400Routing constraints cannot be satisfied
service_unavailable503Service temporarily unavailable
unsupported_modalities400Requested modality not supported
* provider_error returns the upstream provider’s HTTP status code. Common values: 502 (bad gateway), 504 (timeout), 429 (provider rate limit).