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-After if 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.