Errors & troubleshooting
Find the next step from a status code.
Start from the status code
| Status code | Meaning | What to do |
|---|---|---|
400 | Invalid request | Check the model ID, message format and parameters. |
401 | Authentication failed | Make sure you use the full API key and it is not disabled. |
402 | Insufficient balance | Check your available balance and retry after a top-up clears. |
429 | Rate limited or quota exhausted | Check the key's daily quota and request rate; avoid immediate retries. |
5xx | Upstream error | Retry later; requests that never entered generation have their hold released and are not billed. |
Still can't connect
- Confirm the Base URL matches the right API format, without a duplicated
/v1. - Confirm you entered the full key, not the masked prefix shown in the UI.
- Copy the real ID from the model catalog and test with a minimal request first.
- Check the error body returned by your client and the usage records to diagnose upstream errors.