有余额却提示“无可用渠道”?按分组、模型和渠道排查
排查 API 无可用渠道:区分账户余额、令牌额度、密钥分组、模型标识和上游状态,整理有效反馈信息。
余额可用与路由可用是两个条件
“无可用渠道”通常表示当前请求没有匹配到可处理它的渠道。账户有余额只能说明账户额度这一项,不能证明令牌分组、请求模型和渠道状态都满足要求。具体原因要结合完整报错正文与服务端记录判断。
慧根当前按 Codex 和 Claude 分组接入。用 Claude 分组令牌请求 Codex 对应模型,即使账户有余额,也可能找不到匹配渠道。不要为排查此问题反复充值。
步骤 1:确认正在使用哪枚令牌
记录发生时间与原始报错
先暂停重复请求,记下客户端版本、时间和去掉密钥的错误正文;若有请求 ID 一并保留。
完成后检查:有一条具体失败记录可供核对,而不是只记得“今天不能用”。
到API 令牌页检查出问题令牌的分组,而不是只看账户默认分组。为不同客户端分别创建对应分组的令牌,能减少配置混用。
随后确认客户端实际读取的就是这枚令牌。有的客户端沿用旧环境变量或独立配置目录;如果你只在网页新建令牌,却没有更新客户端,实际请求仍可能使用旧令牌。检查时只记录令牌名称,不公开完整值。
步骤 2:把模型、协议和地址一起核对
模型名称必须与当前分组支持的标识一致,不能把界面显示名、其他平台别名或模型系列名直接当作请求标识。参考价格页及当前配置助手,核对大小写、版本和后缀。
再核对客户端发送的协议。Codex 当前配置使用 Responses;Claude Code 使用 Messages。即使模型名称看起来正确,错误协议也可能导致调用失败。地址规则参见/v1 路径教程。
对照配置助手重新核对参数
打开一键配置页选择自己的客户端,比较页面的模型与分组和当前客户端配置。必要时重新运行助手输入正确令牌,再做一次小请求。
完成后检查:Codex 用 Codex 分组与 Responses;Claude Code 用 Claude 分组与 Messages。模型标识与本站当前支持项一致。
步骤 3:检查额度限制与渠道状态
检查账户余额、令牌额度限制、有效期、模型限制,以及是否设置了其他访问条件。各类限制对应的错误信息可能不同,不应全部归为“渠道坏了”。
若分组、模型和协议已确认无误,渠道仍可能因临时不可用、并发限制、维护或上游错误无法服务。这部分需要运营方结合日志核查。适当降低并发,稍后进行一次小请求;持续失败时提交信息,不要无限重试。
步骤 4:提交一份能定位的报错
- 发生时间及所在时区。
- 客户端名称与版本、请求模型、令牌分组。
- HTTP 状态、去掉敏感信息的报错正文、请求 ID(如有)。
- 是否所有请求失败,还是特定模型或并发情况下失败。
先在调用记录查找对应时间。不要发送完整 API 令牌、认证头或包含密钥的终端截图。客服联系方式见服务与联系页。
发生时间(带时区):
客户端与版本:
请求模型与令牌分组:
HTTP 状态与错误正文(去掉密钥):
请求 ID(如有):
是否持续失败 / 是否只在并发时失败: