排查 API 错误与限制
根据 HTTP 状态码、错误 code 和请求症状找到下一步。
先记录 HTTP 状态码、错误 type 或 code，再检查密钥、路径、模型和额度。不要在工单、日志或截图中粘贴完整 API Key。
错误快查
| HTTP | type 或 code | 原因 | 下一步 |
|---|---|---|---|
400 | invalid_request_error | JSON、字段、路径参数或认证头组合无效 | 检查请求体与协议页 |
401 | authentication_error | 密钥缺失、无效或已撤销 | 重新读取环境变量，必要时创建新密钥 |
401 | key_expired | 密钥过期 | 创建新密钥或修改未过期密钥的有效期 |
403 | model_not_allowed | 套餐或密钥白名单不允许模型 | 调用 /v1/models，或改用 auto |
404 | invalid_request_error | 路径或模型不存在 | 检查 Base URL 和模型 ID |
405 | invalid_request_error | HTTP 方法不允许 | 根据端点表改用 GET 或 POST |
429 | key_spend_limit | 单把密钥的花费上限耗尽 | 检查预算，确需继续时再调整该密钥的上限 |
429 | quota_exceeded | 账号的免费、独立 API 或 Auto 额度耗尽 | 查看用量页和套餐状态 |
500 | api_error | 服务端执行失败 | 保留请求时间和错误 ID，减小请求后重试 |
常见症状
Anthropic 路径返回 404
检查 Base URL 是否误写为 https://api.optiwaves.app/v1。如果客户端自行追加 /v1/messages，Base URL 应当是 https://api.optiwaves.app。
模型在手册中存在，但请求返回 403
用当前密钥调用 /v1/models，检查 API Key 允许的模型，并对照模型与价格确认套餐包含该模型。
流中断或没有结束标记
记录最后一个 SSE 事件。Responses 应当以完成、未完成或失败事件结束；Chat Completions 以 [DONE] 结束；Messages 以 message_stop 结束。
图片请求返回 400
检查格式、大小、数量和模型。图片必须是 data URL 或 Anthropic base64 内容，不能是远程 URL。
下一步
售后群 1055897442