故障排查
先检查四样东西: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 密钥、密码、验证码和私人对话内容。联系方式见安全与支持。