Errors

Common status codes and how to fix them.

Common HTTP status codes

400 — Invalid input (missing required field, invalid JSON, etc.)
401 — Missing/invalid API key
403 — API key lacks required permission (e.g. needs write)
404 — Resource not found
429 — Rate limit exceeded (if enabled)
500 — Server error

Troubleshooting checklist

401 Unauthorized

Verify you sent Authorization: Bearer ... or X-API-Key.
Make sure the key is active and not expired.
Confirm you’re calling the correct base URL.

403 Forbidden

Confirm the key has the right permission for the endpoint (read vs write).

400 Bad Request

Check required fields: for chat completions you need message and model.
Validate JSON formatting and content types.

500 Server Error

Retry once after a short delay.
If it persists, contact support with request ID/timestamp.