FAQ and troubleshooting
Find your error code or the problem you’re seeing below.
Error codes
401 Unauthorized
Your API key wasn’t accepted.
- Check that the key starts with sk- and nothing was cut off when you copied it
- Check the header format: Authorization: Bearer sk-xxx
- On the API Key page, check that the key hasn’t expired or been disabled
- Check that the key hasn’t hit its USD limit
403 Forbidden
The key or account isn’t allowed to make this request.
- Your tier doesn’t include the model. Pick a free model or a Weekly Featured model, or see what Plus includes in Plans and tiers
- The Channel set on this key doesn’t include that model
- The key only allows certain models, and this isn’t one of them
- The key has an IP whitelist and your IP isn’t on it
404 Not Found
We couldn’t find that model or endpoint.
- Compare the model ID with the Models page, capital letters included
- Check the endpoint path, for example /v1/chat/completions
- The model was retired, or your Channel setting or plan doesn’t include it
429 Too Many Requests
You’ve hit a limit.
- Send fewer requests at once and space them out
- Wait a moment, then try again
- If the error mentions your wallet, top up and try again. Check-in rewards go to your usage allowance, not your wallet
- Limits apply to your account and to each key
- The x-ratelimit-* response headers show your current limits
500 Internal Server Error
Something went wrong on our side.
- These don’t last long. Try again in a minute
- If it keeps happening, tell us through Feedback
- Check the status page and console notices for maintenance
Common problems
"Model not found"
- Copy the model ID exactly from the Models page (it’s case-sensitive)
- Check that your plan includes the model
- Check that your key’s Channel setting includes the model
- If the key only allows certain models, add this one
"Insufficient balance"
- Check your usage allowance and wallet on the Dashboard. Billing and balance explains which is used first
- When your usage allowance runs out, requests use your wallet. Check that it has funds and hasn’t hit the monthly limit in Billing preferences
- Check the key’s own USD limit too. It can run out while your wallet still has money
More allowance or Plus
- Check in every day for free usage allowance
- Invite friends to earn allowance, and free Plus time once enough of them qualify
- Upgrade to Plus for every model and no daily cap on Weekly Featured models, or top up your wallet
Streaming not working
- Check that the request body has "stream": true
- Your client needs to read SSE (Server-Sent Events)
- A proxy or CDN in between can hold back the stream; check its buffering settings
Replies cut off
- Raise max_tokens if it’s set low
- Very long replies can hit the model’s output limit
- Long replies can time out; raise the timeout in your app
Base URL problems
- In SDKs, base_url ends with /v1. Don’t repeat the path after it
- For cURL, use the full URL: the API origin followed by the endpoint path, such as /v1/chat/completions
- Remove extra slashes or spaces
Page is blank or won’t load
- Ad blockers like AdBlock, uBlock Origin or AdGuard can block parts of the page. Allow this site in yours
- Press Ctrl+Shift+R (Mac: Cmd+Shift+R) to reload without the cache
- Open the browser console (F12) and look for errors
Verification email didn’t arrive
- Check your spam or junk folder
- Check the address for typos
- Wait 1 to 2 minutes and send it again
Troubleshooting steps
- Find the error code (401, 403, 404, 429 or 500)
- Check that the key is active, not expired and under its USD limit
- Check the model ID and endpoint path
- Check the status page and console notices
- If it still fails, send us the error message through Feedback
Related guides
- Check your settings in Base URL and authentication
- Check a key or create a new one in API key management
- Check your balance and add funds in Billing and balance
- See which models you can use in Models and rules
