主题
⚠️ 常见报错速查
QQ 群里发「错误码」(如
524)或/报错 524,机器人也能自动解答。
HTTP 错误码
| 代码 | 名称 | 原因 | 解决 |
|---|---|---|---|
| 400 | 请求错误 | 参数格式错 / messages 为空 / 上下文超长 | 检查请求体,缩短上下文 |
| 401 | 未授权 | Key 错误/失效/没填/多空格 | 重新复制 key,确认没过期,base_url 别填错 |
| 402 | 余额不足 | 账户或令牌额度用尽 | 钱包管理 → 额度充值 |
| 403 | 无权限 | ①分组无权用该模型 ②令牌分组不对 ③IP 限制 | 确认分组(模型与分组),换分组或联系管理员 |
| 404 | 找不到 | ①base_url 填错(少 /v1 或路径错)②模型名拼错 | 核对 base_url(接入教程)和模型名 |
| 429 | 限流 | 请求太频繁 / 并发过高 | 降低频率、减少并发、稍等重试 |
| 500 | 服务器错误 | 上游模型内部错误 | 换模型或稍后重试 |
| 502 | 网关错误 | 上游返回异常 | 重试,或换分组/模型 |
| 503 | 无可用渠道 | 该分组该模型暂无可用渠道 | 换分组或稍后重试;群发 /渠道 看死活 |
| 504 | 网关超时 | 上游响应太慢 | 重试、减少输出、换模型 |
| 520~522 | CF 错误 | Cloudflare 与源站连接异常 | 换直连 api.synai996.space |
| 524 | ⭐ CF 超时 | 走 CF 域名时源站响应超 100 秒(长输出/思考模型常见) | 换直连 api.synai996.space;或开启 stream 流式;或调小 max_tokens |
文字提示类
| 提示 | 原因 | 解决 |
|---|---|---|
| 无可用渠道 | 分组下模型暂无可用渠道 | 换分组或稍后重试 |
| 额度/余额不足 | 令牌或账户余额用尽 | 钱包管理 → 额度充值 |
| 命中敏感词 | 请求内容被安全过滤 | 修改内容,避免违规表述 |
🔧 万能排查三步
- 超时/连不上 → base_url 换直连
https://api.synai996.space(绕过 CF) - 报权限/渠道错 → 确认令牌分组对不对,或换个分组
- 还不行 → 带错误码找管理员,或群发
/报错 <代码>
