FAQ 与故障排查
本页整理常见问题及解决方案。
Base URL 要不要加 /v1？
大多数客户端要加：
https://monkeytheme.com/v1如果客户端会自动拼 /v1，就填：
https://monkeytheme.com判断方法：
- 报 404，可能是路径错了。
- 请求地址出现
/v1/v1/chat/completions，说明重复拼了/v1。
API Key 填哪里？
填到客户端的 API Key / 密钥 / Token / Bearer Token 字段。
HTTP Header 格式：
Authorization: Bearer sk-你的APIKey401 INVALID_API_KEY
原因：API Key 无效。
处理：
- 检查是否复制完整。
- 删除前后空格。
- 确认没有把邮箱密码当 API Key。
- 重新创建一个 key 测试。
403 Permission Denied
可能原因：
- 余额不足。
- 账号状态异常。
- 模型不在当前分组可用范围。
- API Key 被禁用。
处理：
- 检查余额。
- 换一个模型。
- 重新创建 key。
- 联系管理员。
404 Not Found
常见原因：Base URL 写错。
正确：
https://monkeytheme.com/v1完整接口：
https://monkeytheme.com/v1/chat/completions不要写成：
https://monkeytheme.com/v1/v1429 Rate Limit
请求过快或并发过高。
处理：
- 降低并发。
- 增加重试间隔。
- 长任务拆分。
- 避免多个客户端共用一个 key 同时跑。
503 Service temporarily unavailable
含义：上游暂时不可用、账号额度耗尽、模型繁忙或通道切换中。
处理：
1. 等 30-60 秒重试。 2. 换一个模型。 3. 降低并发。 4. 如果持续出现，联系管理员。
Model Not Found
模型名错误或当前不可用。
请先查看模型列表：
curl https://monkeytheme.com/v1/models \
-H "Authorization: Bearer sk-你的APIKey"复制返回里的模型 id。
客户端能扣费但没有回复
常见于 Claude Code 或某些代理工具。
原因一般是接口协议选错：
- OpenAI Compatible 应走
/v1/chat/completions - Anthropic 应走
/v1/messages
解决：
- 优先选择 OpenAI Compatible。
- Claude 模型也可以在 OpenAI Compatible 下调用。
- 如果工具必须 Anthropic 原生格式，检查
ANTHROPIC_BASE_URL。
充值不到账
处理：
1. 刷新页面。 2. 查看订单状态。 3. 等待 1-3 分钟。 4. 仍未到账，联系管理员并提供账号邮箱、订单时间、支付截图。
输出质量不稳定
建议：
- 重要任务用更强模型：
gpt-4o、claude-3-opus-latest。 - 编程任务用：
gpt-4o、claude-sonnet-4-20250514-20250514。 - 降低
temperature，例如 0.2-0.7。 - 给更清楚的任务说明。
如何联系支持
联系管理员时请提供：
- 账号邮箱
- 模型名
- 报错时间
- 客户端名称
- 报错截图或文本
- API Key 前 6 位和后 4 位
联系支持时请勿提供完整 API Key。