常见问题

先做这一步

在终端里用你的 Key 直接请求一次。这一步绕开了所有客户端，结果能告诉你问题在哪：

查模型列表（任意分组）

curl -sS https://2api.dev/v1/models -H "Authorization: Bearer sk-你的Key"

Claude（CC-Max 分组）

curl -sS https://2api.dev/v1/messages \
  -H "Authorization: Bearer sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"模型名","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

GPT（GPT 分组）

curl -sS https://2api.dev/v1/responses \
  -H "Authorization: Bearer sk-你的Key" \
  -H "content-type: application/json" \
  -d '{"model":"模型名","input":"hi"}'

Windows PowerShell 里把 curl 换成 curl.exe，并把 \ 换行合并成一行。

自检结果	说明	去看
正常返回内容	Key 和地址都没问题，问题在客户端配置	对应工具的分类
返回 401	Key 错了、被删了或被禁用	账号与额度
返回 403 / 429 并带中文说明	额度、分组或限流问题，按提示处理	账号与额度、网络与报错码
提示模型不存在	Key 和地址没问题，只是模型名不对	用 /v1/models 查模型名
连不上、超时	网络或代理问题	网络与报错码

按分类找

账号与额度

兑换失败、有额度却报错、额度什么时候重置、Key 和分组。

Claude Code

一直要求登录、Invalid API key、认证冲突、模型不存在、扣费偏多。

Codex

401、stream disconnected、反复 Reconnecting、模型和推理档位。

其他客户端

/v1 重复、Cherry Studio、Cursor、CC Switch、magpie、Claude Desktop。

网络与报错码

代理干扰、429、503、529、超时。