Skip to content

⚠️ 常见报错速查 ​

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~522CF 错误Cloudflare 与源站连接异常换直连 api.synai996.space
524⭐ CF 超时走 CF 域名时源站响应超 100 秒(长输出/思考模型常见)换直连 api.synai996.space;或开启 stream 流式;或调小 max_tokens

文字提示类 ​

提示原因解决
无可用渠道分组下模型暂无可用渠道换分组或稍后重试
额度/余额不足令牌或账户余额用尽钱包管理 → 额度充值
命中敏感词请求内容被安全过滤修改内容,避免违规表述

🔧 万能排查三步 ​

  1. 超时/连不上 → base_url 换直连 https://api.synai996.space(绕过 CF)
  2. 报权限/渠道错 → 确认令牌分组对不对,或换个分组
  3. 还不行 → 带错误码找管理员,或群发 /报错 <代码>

Synai996 AI API 中转服务