Error Codes
The following are standard HTTP troubleshooting guidelines. Exact error bodies and request-ID headers depend on the deployed gateway contract.
- 400 — Check the request structure, model identifier and supported parameters.
- 401 — Check your Authorization header and key.
- 403 — Verify account and route permissions.
- 404 — Verify the endpoint and model availability.
- 429 — Respect
Retry-Afterif present; use bounded exponential backoff with jitter. - 5xx — Temporary gateway or upstream failure. Retry only when safe, with a bounded retry policy.
Avoid blind retries for operations that can perform writes. Share a sanitized request identifier and timestamp with support; never share API keys.