疑难杂症
本页面收录了使用 PeterPark API 时可能遇到的各类技术问题及解决方案。
API 调用问题
401 Unauthorized（未授权）
原因： API Key 无效、已过期或格式错误。
解决方案：
- 检查 API Key 是否完整复制，没有多余空格
- 登录控制台确认 Key 是否仍然有效（未被禁用或删除）
- 确认
Authorization请求头格式正确：Bearer sk-pp-your-key
429 Too Many Requests（请求过多）
原因： 短时间内请求频率超过限制。
解决方案：
- 在代码中添加请求重试逻辑，遇到 429 时等待后重试
- 减少并发请求数量
- 如业务需要高并发，请联系客服申请提升限额
500 Internal Server Error（服务器错误）
原因： 服务端临时故障。
解决方案：
- 等待 1-2 分钟后重试
- 检查 服务状态页 确认是否有故障公告
- 如持续出现，请联系客服并提供请求 ID
模型返回空内容
原因： 请求参数异常或内容被安全过滤。
解决方案：
- 检查
messages数组格式是否正确 - 确认
max_tokens参数不为 0 - 检查请求内容是否触发了安全过滤
网络连接问题
连接超时
症状： 请求长时间无响应，最终超时报错。
解决方案：
- 检查本地网络连接是否正常
- 尝试 ping
api.peterpark.cn测试连通性 - 如使用代理，确认代理配置正确
- 尝试切换网络环境（如从 WiFi 切换到手机热点）
SSL 证书错误
症状： 报错 SSL certificate verify failed。
解决方案：
- 更新系统根证书
- Python 用户：
pip install --upgrade certifi - 临时方案（不推荐生产环境）：在请求中禁用 SSL 验证
工具配置问题
Claude Code 无法连接
检查步骤：
bash
# 确认环境变量已设置
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY
# 测试 API 连通性
curl https://api.peterpark.cn/v1/models \
-H "Authorization: Bearer $ANTHROPIC_API_KEY"Cursor 无法使用自定义模型
解决方案：
- 在 Cursor 设置中确认 API Key 和 Base URL 填写正确
- 模型名称需要与 PeterPark 支持的模型 ID 完全一致
- 重启 Cursor 后再试
余额与计费问题
余额扣减异常
如发现余额扣减与实际用量不符，请：
- 在控制台查看详细的用量明细
- 对比请求日志中的 Token 数量
- 如有疑问，联系客服并提供具体的请求时间和 ID
仍未解决？
如果以上方案都无法解决你的问题，请前往 售前售后 页面联系我们的技术支持团队。