文档 / 帮助

故障排查

先检查四样东西:API 地址、协议、密钥的分组、完整模型 ID。再根据错误正文处理。同一个状态码可能有不同原因,以正文为准。

按报错定位

状态码 / 报错 常见原因 怎么处理
创建密钥时提示「请选择分组」 没有选分组 在「分组」里选一个,见分组说明
400 参数错误 请求 JSON 写错、模型不支持某个参数、协议用错 用最小示例去掉多余参数再试
401 无效的令牌 密钥不完整、有空格、已删除或已禁用 从控制台重新复制密钥;检查客户端是不是还在读旧配置
403 您的 IP 不在令牌允许访问的列表中 密钥设置了 IP 白名单 在密钥「编辑」里调整 IP 白名单
403 无权访问 xxx 分组 / 分组 xxx 已被弃用 密钥所在的分组已下线 在密钥「编辑」里换一个分组
403 其它 密钥过期、密钥额度用完、账户被限制 查看密钥设置和错误正文
404 api_moved 把 peroai.cc 当成了 API 地址 地址改成 https://api.peroai.cc
404 其它 路径重复(/v1/v1)、协议用错、模型上游暂时没有账号 对照地址表检查;换一个模型试试
503 分组 xxx 下模型 yyy 无可用渠道 模型不在这把密钥的分组里,或模型 ID 拼错 从模型广场复制该分组的模型 ID,或换一把对应分组的密钥
用户额度不足 / 预扣费额度失败 账户余额不够 到钱包充值
429 请求太频繁,或上游容量不足 降低并发,稍等后有限次重试
502(claude-ccmax 分组) 这个分组只接受 Claude Code 客户端 其它客户端请用 claude-kiro 分组
500 / 502 / 503 其它 上游临时故障 看服务状态,稍后重试;持续出现请反馈
524 非流式请求 125 秒内没有返回 改用流式请求("stream": true)
超时 / 流式中断 网络、代理、客户端超时设置 先看使用日志是否已扣费,再决定是否重新提交
返回网页 HTML,不是 JSON 用了控制台地址、被代理拦截、路径错误 使用 https://api.peroai.cc 和正确的接口路径

模型广场里有,却调用不了

模型广场是全站的模型目录。一把密钥只能用它所在分组的模型。打开「API 密钥」看这把密钥的分组,再到模型广场里找该分组那一节。

模型 ID 要完整复制,注意版本后缀、大小写和多余的空格。

curl 能用,客户端不行

通常是客户端的协议选择、自动追加的路径、默认模型或额外参数有问题。先把客户端配置精简到只有 API 地址、密钥、模型三项,发一条纯文字消息。

只有多轮对话、图片或工具调用失败的,保存那次的报错,确认模型和分组是否支持这个功能。

某个分组整体不可用

打开服务状态,可以看到每个分组最近 24 小时和 7 天的可用率、延迟和首字时间。上游故障时可以临时换一个分组:新建一把其它分组的密钥,或在原密钥的「编辑」里改分组。

充值没到账

按充值核对链上交易、网络和实际到账数量,尤其是交易所扣手续费后的金额。不要重复付款。

反馈问题时请提供

发生时间和时区:
客户端名称和版本:
协议 / 接口路径:
模型 ID 和分组:
HTTP 状态码和错误正文(含 request id):
能否稳定复现:

发送前删掉 API 密钥、密码、验证码和私人对话内容。联系方式见安全与支持。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。