FAQ
FAQ
Run a self-check first to see whether the problem is the key, the address or the client. Then find your answer by category.
Do this first
Section titled “Do this first”In a terminal, send one request directly with your key. This skips every client, and the result tells you where the problem is:
curl -sS https://2api.dev/v1/models -H "Authorization: Bearer sk-your-key"curl -sS https://2api.dev/v1/messages \ -H "Authorization: Bearer sk-your-key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"model-name","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'curl -sS https://2api.dev/v1/responses \ -H "Authorization: Bearer sk-your-key" \ -H "content-type: application/json" \ -d '{"model":"model-name","input":"hi"}'In Windows PowerShell, replace curl with curl.exe and join the lines that end in \ into one line.
| Self-check result | What it means | Where to look |
|---|---|---|
| Returns content normally | The key and the address are fine. The problem is in the client config | The category for your tool |
| Returns 401 | The key is wrong, deleted or disabled | Account and quota |
| Returns 403 / 429 with a message in Chinese | A quota, group or rate-limit problem. Follow the message | Account and quota, Network and error codes |
| Says the model does not exist | The key and the address are fine. Only the model name is wrong | Look up the model name with /v1/models |
| Can’t connect, or times out | A network or proxy problem | Network and error codes |
Find by category
Section titled “Find by category”Account and quota
Redemption fails, errors despite having quota, when quota resets, keys and groups.
Claude CodeRepeated login prompts, Invalid API key, auth conflict, model not found, higher charges than expected.
Codex401, stream disconnected, repeated Reconnecting, models and reasoning levels.
Other clientsDoubled /v1, Cherry Studio, Cursor, CC Switch, magpie, Claude Desktop.
Network and error codesProxy interference, 429, 503, 529, timeouts.