Skip to main content
All error responses return JSON with at least an error or detail field.

Error response shape

HTTP status codes

Error examples

401 — Invalid API key

The key is missing, malformed, or has been revoked. Double-check the Authorization header.

403 — Plan upgrade required

404 — Deployment not found

The deployment_id either does not exist or belongs to a different user.

409 — Duplicate deployment

429 — Rate limit exceeded

Wait the number of seconds in retry_after_seconds before retrying. See also the Retry-After response header.

503 — Deployment not active

The model container is still starting up. Check the status and retry when ACTIVE.

503 — Container unreachable

The container is registered as ACTIVE but did not respond. Usually resolves within seconds — retry with exponential backoff.
Python
Node.js