常见错误 & 解决
报错先别慌 —— 下面按"你看到的提示"分类，每条给原因和你该怎么做。用浏览器 Ctrl/⌘ + F 搜关键词最快。
401 / invalid token / 令牌无效
原因：API Key（令牌）的问题。多半是：
- Key 复制错了（多了空格、少了字符）
- Key 已在控制台被删除或禁用
- 客户端里没填对位置，或没带
Bearer
怎么做：
- 回 控制台 → 令牌 确认这个令牌还在、状态正常。
- 重新 复制 一次，整段替换，注意首尾别带空格。
- 确认
base_url也填对了（见各客户端教程）。
余额不足 / insufficient quota / INSUFFICIENT_BALANCE
原因：账户余额或该令牌的额度用完了。
怎么做：去 控制台 充值；或检查这个令牌是不是设了额度上限，调高即可。
充值没到账？
USDT / 加密充值必须按页面显示的精确金额支付（多付、少付都不会自动入账）。付错了别急，截图付款记录联系客服人工处理。
无可用渠道 / 当前分组下无可用渠道 / no available channel
原因：你请求的模型，在你账号所属的分组里没有对应渠道。常见于填了一个我们没上架、或不在你套餐内的模型名。
怎么做：
- 打开 控制台 看当前可用模型列表，挑一个里面有的。
- 确认模型名拼写完全一致（大小写、横杠都要对）。
- 确认无误仍报错 → 可能是你的分组权限问题，联系客服确认。
模型不存在 / model_not_found
原因：模型名拼错，或该模型不在你的分组。
怎么做：和上一条一样 —— 去控制台对着模型列表，把名字一字不差地填进客户端。
断流 / stream disconnected / Connection error / 高负载
原因：
- 上游高峰期繁忙，或瞬时网络抖动
- 国内直连德国服务器，链路偶尔不稳
怎么做：
- 直接重试一次，多数能成。
- 频繁出现 → 换一个模型试试（不同模型走不同上游）。
- 持续不行 → 截图联系客服，我们看后台渠道状态。
请求超时 / timeout
原因：网络问题居多，尤其国内直连海外。
怎么做：重试；如长期慢，建议挂加速 / 走代理后再连。
reasoning / 思考强度 不生效
原因：两套接口的写法不一样，混用就被忽略。
| 接口 | 正确写法 |
|---|---|
/v1/chat/completions | 字符串："reasoning_effort": "high" |
/v1/responses（Codex 等） | 对象："reasoning": { "effort": "high" } |
怎么做：按你用的接口选对应写法。在 Codex 里直接用配置项 model_reasoning_effort 即可，不用手写。
控制台页面 500 / 白屏 / 点哪都报错
原因：浏览器开了 谷歌翻译（自动翻译整页）会和控制台冲突，导致点击页面报错。
怎么做：
- 关掉该页面的谷歌翻译（地址栏翻译图标 → 显示原文），刷新即可。
- 我们已在服务端加了防护，但仍建议浏览这类控制台别开整页翻译。
已知且已加固
这个问题我们已经做了兼容处理。如果你更新后仍遇到，关掉翻译刷新一次基本就好。
还是搞不定？
把报错原文截图 + 你用的客户端和模型发给客服，会比口述快很多。