报错与排查¶

本页汇总了目前统计到的常见报错类型和成因，方便你在反馈之前自行初步定位问题，节省来回沟通时间。

反馈时请尽量提供：

• 「你使用的客户端」名称与版本
• 完整的报错信息（文字 + 截图）
• 相关配置截图（Base URL / API Key / 模型名 / 最大输出 Token 等）

1. 空回复 / no candidates returned¶

最常见的一类问题，通常有以下原因：

1. 最大输出 Token 设置过小
2. 比如只设置了几百 Token，模型的「思考过程」就占满了额度，自然没有内容输出
3. 建议：
   • 最大输出 Token 设置在 10000～30000 区间
   • 上下文长度设置在 200000～300000 区间，兼顾速度与质量
4. 对话内容触发审查或异常状态
5. 对话涉及敏感内容，被 Google 审查拦截
6. 当前会话内部某条消息出错，导致后续对话无法正常使用
7. 建议：
   • 新建一个全新会话再试
   • 换一组提示词 / 角色卡，避免敏感话题
   • 尝试切换为**非流式输出**，审查策略会有差异
8. 老客户端使用 maxtokens 字段
9. 新版 API 使用 maxOutputTokens 字段
10. 建议更新客户端到最新版本，或者禁用旧字段配置

2. bad response status code 524 / 530 / 502 / 504¶

这一类属于「网关 / 网络异常」：

1. 本地网络不佳
2. 524 是 Cloudflare 的超时报错
3. 建议：
   • 使用流式传输
   • 尝试切换主 / 备 API 端点

3. Unable to submit request because it has a maxOutputTokens value of 65537...¶

含义：客户端把 maxOutputTokens 设置成了 65537 或更大，超过了 Google 允许的上限。

解决方法：

• 将「最大输出 Token」调到 小于 65537 的值（推荐 10000～30000）
• 调整完后重新尝试

4. bad response status code 413¶

请求体太大：

• 文本输入量过大：一般几十万字是没问题的，但如果混合了大量图片，体积会非常可观
• 图片过多或单张图片过大

当前限制：

• 最大允许上传内容：HK线路 25 MB，主站 50 MB

建议：

• 减少图片数量或分批发送
• 文本可适当分段请求，避免巨长对话一次性发送

5. bad response status code 503¶

含义：当前**无可用渠道**，号池整体封空。

• 如果你遇到 503，且多次重试仍然如此，大概率是号池状态异常
• 请尽快联系我，我会及时切换号池或补号

6. 401 报错¶

通常是密钥或权限问题：

• 密钥无效 / 已删除 / 粘贴不完整
• 使用了错误的 Key（例如填成兑换码，而不是 sk- 密钥）

解决方法：

1. 回到主站钱包页面，重新创建一个新的 sk- 密钥
2. 确保「没有乱勾选额外权限」——按默认配置创建即可
3. 在客户端中删除旧 Key，完整粘贴新密钥

7. 403 报错¶

余额不足，可以在 https://new.12ai.org/console/topup 界面自助充值，或者闲鱼下单，重试使用兑换码。

8. 仍无法解决时¶

这样我可以尽可能快速地帮你恢复服务，避免来回多轮问答。