测试模型列表
将尝试 GET
/v1/models（若 baseUrl 已以 /v1 结尾则不重复添加）。/v1/models（若 baseUrl 已以 /v1 结尾则不重复添加）。| 错误码 | 含义 | 常见原因 | 解决方法 |
|---|---|---|---|
401 |
身份验证失败 | • API Key错误或失效 • 请求头格式不正确 • 账户权限不足 |
• 检查API Key是否正确 • 确保使用 Bearer 前缀• 验证账户状态和余额 |
403 |
权限不足/内容被拦截 | • 账户权限不够 • 内容违反使用政策 • 组织访问限制 |
• 检查账户权限等级 • 修改输入内容 • 联系服务商客服 |
404 |
资源未找到 | • API端点错误 • 模型名称不存在 • 路径拼写错误 |
• 确认Base URL正确 • 检查模型名称 • 参考官方文档 |
429 |
请求限制 | • 超出频率限制 • 账户配额不足 • 并发请求过多 |
• 降低请求频率 • 充值账户余额 • 实现重试机制 |
500 |
服务器内部错误 | • 服务商系统故障 • 临时服务中断 |
• 稍后重试 • 检查服务状态页 • 联系技术支持 |
529 |
服务过载 | • 服务器负载过高 • 用户请求激增 |
• 等待几分钟后重试 • 避开高峰时段 • 使用流式响应 |
| 服务商 | 特殊注意事项 |
|---|---|
| OpenAI | • 2024年后采用预付费模式，余额为0时立即停止服务 • 不同等级账户有不同的RPM/TPM限制 • 新账户通常从Tier 1开始，需要逐步升级 |
| Claude | • 使用等级制度(Tier 1-4)，根据消费自动升级 • 长请求建议使用流式API • 529错误表示API临时过载 |
| Groq | • 速度快但有严格的频率限制 • 免费用户限制较低 • 建议实现请求队列 |
| OpenRouter | • 支持多个模型提供商 • 403可能是内容审核触发 • 检查error.metadata获取详细信息 |
💡 建议：遇到错误时先检查API Key和余额，再核对请求格式和频率限制。持续出错请查看服务商状态页面。