huigen.慧根 API
故障排查

有余额却提示“无可用渠道”?按分组、模型和渠道排查

慧根 API 编辑 · 发布 / 更新于

排查 API 无可用渠道:区分账户余额、令牌额度、密钥分组、模型标识和上游状态,整理有效反馈信息。

有余额却提示“无可用渠道”?按分组、模型和渠道排查操作路线图
图解路线 · 正文按步骤说明操作与检查结果。 点击图片查看大图

余额可用与路由可用是两个条件

“无可用渠道”通常表示当前请求没有匹配到可处理它的渠道。账户有余额只能说明账户额度这一项,不能证明令牌分组、请求模型和渠道状态都满足要求。具体原因要结合完整报错正文与服务端记录判断。

慧根当前按 Codex 和 Claude 分组接入。用 Claude 分组令牌请求 Codex 对应模型,即使账户有余额,也可能找不到匹配渠道。不要为排查此问题反复充值。

步骤 1:确认正在使用哪枚令牌

记录发生时间与原始报错

先暂停重复请求,记下客户端版本、时间和去掉密钥的错误正文;若有请求 ID 一并保留。

完成后检查:有一条具体失败记录可供核对,而不是只记得“今天不能用”。

到API 令牌页检查出问题令牌的分组,而不是只看账户默认分组。为不同客户端分别创建对应分组的令牌,能减少配置混用。

随后确认客户端实际读取的就是这枚令牌。有的客户端沿用旧环境变量或独立配置目录;如果你只在网页新建令牌,却没有更新客户端,实际请求仍可能使用旧令牌。检查时只记录令牌名称,不公开完整值。

排查令牌时核对客户端与分组的对应关系
图 2 · 分组核对示意,非后台截图。 点击图片查看大图

步骤 2:把模型、协议和地址一起核对

模型名称必须与当前分组支持的标识一致,不能把界面显示名、其他平台别名或模型系列名直接当作请求标识。参考价格页及当前配置助手,核对大小写、版本和后缀。

再核对客户端发送的协议。Codex 当前配置使用 Responses;Claude Code 使用 Messages。即使模型名称看起来正确,错误协议也可能导致调用失败。地址规则参见/v1 路径教程。

对照配置助手重新核对参数

打开一键配置页选择自己的客户端,比较页面的模型与分组和当前客户端配置。必要时重新运行助手输入正确令牌,再做一次小请求。

完成后检查:Codex 用 Codex 分组与 Responses;Claude Code 用 Claude 分组与 Messages。模型标识与本站当前支持项一致。

步骤 3:检查额度限制与渠道状态

检查账户余额、令牌额度限制、有效期、模型限制,以及是否设置了其他访问条件。各类限制对应的错误信息可能不同,不应全部归为“渠道坏了”。

若分组、模型和协议已确认无误,渠道仍可能因临时不可用、并发限制、维护或上游错误无法服务。这部分需要运营方结合日志核查。适当降低并发,稍后进行一次小请求;持续失败时提交信息,不要无限重试。

步骤 4:提交一份能定位的报错

  • 发生时间及所在时区。
  • 客户端名称与版本、请求模型、令牌分组。
  • HTTP 状态、去掉敏感信息的报错正文、请求 ID(如有)。
  • 是否所有请求失败,还是特定模型或并发情况下失败。

先在调用记录查找对应时间。不要发送完整 API 令牌、认证头或包含密钥的终端截图。客服联系方式见服务与联系页。

发生时间(带时区):
客户端与版本:
请求模型与令牌分组:
HTTP 状态与错误正文(去掉密钥):
请求 ID(如有):
是否持续失败 / 是否只在并发时失败: