报错原文索引

全站报错的汇总表。用 Ctrl+F 搜你屏幕上那行字，找到原因和对应页面。

怎么用这页

1. 按 Ctrl+F，搜报错原文里最独特的那几个字（比如 模型不存在、Invalid）
2. 在下表找到它，看「一句话原因」
3. 点进右边的页面看完整排查步骤

搜不到就换个词

客户端会把服务端的错误包一层，你看到的可能不是原始文案。 搜不出结果时，试试搜状态码（400 / 401 / 403 / 404 / 429 / 500 / 502 / 504）， 或直接去错误码对照。

按报错原文查

报错原文 / 现象	一句话原因	去哪
模型不存在	令牌的分组里没有这个模型	模型不存在
model not found / The model does not exist	同上，或模型名拼写不对	模型不存在
401 Unauthorized	没带令牌，或令牌无效	认证与 401
Invalid API key	令牌写错、已删除、已过期，或用了别家站的 Key	认证与 401
API key is required	请求头里根本没有令牌 —— 配置没生效	认证与 401
令牌已过期	建令牌时设的过期时间到了	认证与 401
余额不足 / Insufficient balance	账户额度用尽	认证与 401 · 余额与扣费
404 page not found（纯文本，不是 JSON）	路径少写 /v1，或多写成 /v1/v1/...	错误码对照
403 Forbidden	IP 白名单不匹配，或令牌设了模型限制	认证与 401
429 / Too Many Requests	请求太密集，或福利档渠道高峰期容量有限	连接与超时
500 / 502 / 504	上游渠道异常或超时	连接与超时
ETIMEDOUT	连不上端点，通常是网络或端点选错	连接与超时
ECONNREFUSED	端点地址写错，或代理拦了请求	连接与超时
SSL certificate problem	代理/防火墙在做中间人，或系统根证书旧	连接与超时
stream error / 流式中断	上游渠道波动或网络抖动	连接与超时
首字很慢，之后正常	福利档渠道特性，不是故障	连接与超时
context length exceeded / 上下文超限	输入超了模型窗口	Claude Code
prompt is too long	同上	Claude Code
扣费比预期多	没算分组倍率（广场是基准价）	余额与扣费
余额没变但请求失败	请求没到上游，或上游未产生有效输出	余额与扣费
充值没到账	支付回调延迟，或需要人工核账	余额与扣费
退款了但额度没变	支付桥接的退款不自动增减额度	余额与扣费
Claude Code 认证失败	ANTHROPIC_BASE_URL 填错（多写/少写 /v1）	Claude Code
Claude Code 费用偏高	缓存未命中	Claude Code
Codex 报 /v1 相关错误	OpenAI 端点必须带 /v1	Codex 专题
Codex 报参数不支持	reasoning 类参数的渠道兼容性差异	Codex 专题
Gemini CLI 连不上	官方 CLI 稳定性不足，本站不提供教程	Gemini 专题
Claude Desktop 外接失败	分组不是 【Claude】Max · 顶享	Claude Desktop

两条能自己动手的判据

不用进群，先自己看一眼，能排除掉一大半情况。

判据一：401 看 code 字段

这是最有用的一条 —— 两种 401 的 code 不同：

你看到的 code	含义	说明
API_KEY_REQUIRED	请求头里没有令牌	属于「配置没生效」：环境变量没读到、请求头没加上、客户端没重启
INVALID_API_KEY	带了，但令牌无效	属于「令牌本身的问题」：写错、已删除、已过期、或别家平台的令牌

一个字段就把问题劈成了两半，排查方向完全不同。详见认证与 401。

判据二：404 看响应体是不是 JSON

404 page not found 是纯文本，不是 JSON。

看到这种非 JSON 的 404，就是路径问题，别去怀疑令牌和分组 —— 那两者出问题时返回的都是 JSON。

最常见的成因：OpenAI 端点漏写 /v1，或 Anthropic 端点多写了 /v1。

通用排查顺序

任何报错都可以按这个顺序走：

1. 看服务状态页 https://status.fluxtoken.ai/ —— 是不是上游在波动
2. 看控制台的错误请求记录 —— 平台允许你查看自己的错误请求，里面有失败原因
3. 核对端点与 /v1 —— 见接口总览的对照表
4. 核对模型名与分组 —— 见模型列表与怎么选分组
5. 改完重启客户端 —— 改分组、改环境变量之后，正在运行的程序不会自动重连
6. 换一个分组试 —— 能通说明是渠道问题，不是你的配置问题

还不行怎么办

1. 服务状态页：https://status.fluxtoken.ai/
2. 快速自查清单 —— 按「症状 → 页面」再走一遍
3. QQ 群 1108757955 · Telegram https://t.me/fluxtokengroup

进群请附上：发生时间、模型名、分组名、完整报错原文、请求 ID。

关于本文档里的报错文案

表中引用的 API_KEY_REQUIRED、INVALID_API_KEY、404 page not found 是实测抓到的原文。其余项目给出的是描述性表述（例如「返回 401 并提示余额不足」）， 因为具体措辞会随客户端和上游渠道变化。 以你实际看到的返回为准，不要拿着描述性文字去逐字比对。

数据快照：2026-10-08 · 站点版本 0.2.11
来源：模型广场接口 · 价格接口
文档站数据随构建自动更新；实时价格、可用性与限额请以控制台实际展示为准。