故障排查

连接失败

检查以下内容：

1. Base URL 是否正确。
   • OpenAI 兼容：https://api.monoai.today/v1
   • Anthropic Messages：https://api.monoai.today
2. 网络是否可以访问 api.monoai.today。
3. 客户端是否要求 https。

401 鉴权失败

• 确认请求头包含 API Key。
• 确认密钥没有多余空格。
• 确认密钥未被删除或过期。
• Anthropic 客户端尝试 x-api-key 或 ANTHROPIC_AUTH_TOKEN。

402 额度不足

检查响应的 error.param。 api_key_limit 表示 Key 限额；plan_quota 表示 Coding Plan 窗口额度；wallet 表示钱包余额。 没有原因字段时，分别检查三项。 钱包有余额不代表 Key 或 Coding Plan 允许继续调用。 详情见错误与状态码。

403 无权访问

• 检查 API Key 的模型限制。
• 检查账号余额与状态。

404 模型不存在

• 重新调用 GET /v1/models。
• 确认模型 ID 大小写和前缀与返回值一致。
• 确认模型当前可用。

429 请求过多

降低请求频率，稍后重试。如果持续出现，请减少并发请求数量。

流式响应中断

• 确认请求体包含 "stream": true。
• 确认客户端支持 SSE。
• 增加客户端读取超时时间。
• 检查网络代理是否缓冲了事件流。

响应很慢或超时

• 长输入和长输出需要更长时间。
• 尝试缩短提示或设置更小的输出上限。
• 为客户端设置合理的超时时间。

图像请求失败

• 确认使用的是图像模型。
• 确认参数符合模型要求。
• 图像接口耗时较长，请增加超时时间。

仍然无法解决

请在控制台请求日志中查看错误信息，并联系支持人员。提供以下信息可以更快定位问题：

• 完整请求 ID（从用量页面的调用详情复制）
• 请求时间
• 模型 ID
• 请求路径
• 返回的状态码与错误信息
• 使用的客户端名称与版本

不要提供完整的 API Key。