Skip to main content

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

  1. Find the error code (401, 403, 404, 429 or 500)
  2. Check that the key is active, not expired and under its USD limit
  3. Check the model ID and endpoint path
  4. Check the status page and console notices
  5. If it still fails, send us the error message through Feedback

Related guides