Boundless API 使用 OpenAI 兼容的错误格式。错误返回 JSON：
```json
{
“错误”：{
"message": "人类可读的描述",
“类型”：“无效请求错误”，
“参数”：“型号”，
“代码”：“未找到模型”
}
}
````
HTTP 状态代码
| HTTP |
意义 |
计费了吗？ |
| 200 |
200成功 |
是（每个代币） |
| 400 |
错误的请求 - 修复您的有效负载 |
没有 |
| 401 |
401 API 密钥无效或丢失 |
没有 |
| 402 |
402学分不足 |
没有 |
| 403 |
403禁止 — 模型访问被拒绝 |
没有 |
| 404 |
404未找到端点或模型 |
没有 |
| 429 |
429超出速率限制 |
没有 |
| 500 |
500无限的内部错误 |
没有 |
| 502 |
502上游提供商错误 |
没有 |
| 503 |
503服务暂时不可用 |
没有 |
| 529 |
529提供程序过载（重试） |
没有 |
错误代码
身份验证（401）
| 代码 |
留言 |
原因 |
行动 |
invalid_api_key |
无效的 API 密钥 |
错误或已撤销的密钥 |
检查仪表板中的键 |
missing_api_key |
无授权标头 |
忘记承载令牌 |
添加“授权：承载 sk-...” |
计费（402）
| 代码 |
留言 |
原因 |
行动 |
配额不足 |
学分不足 |
余额为零或低于最小值 |
添加积分或启用自动充值 |
花费_限制_超出 |
已达到消费限额 |
硬顶打击 |
在“设置” |
请求（400）
| 代码 |
留言 |
原因 |
行动 |
无效请求错误 |
格式错误的请求 |
JSON/架构错误 |
检查请求正文 |
context_length_exceeded |
代币太多 |
输入超出模型上下文 |
减少输入或使用更大的上下文模型 |
无效模型 |
找不到型号 |
拼写错误或已弃用的型号 |
检查模型 |
模型未找到 |
型号不可用 |
模型已删除或受到限制 |
选择替代型号 |
访问（403）
| 代码 |
留言 |
原因 |
行动 |
model_access_denied |
帐户不允许使用型号 |
新手等级限制 |
购买积分来解锁 |
region_restricted |
型号在该地区不可用 |
地理限制 |
使用允许的型号或联系支持人员 |
速率限制 (429)
| 代码 |
留言 |
原因 |
行动 |
rate_limit_exceeded |
请求过多 |
RPM/TPM 达到极限 |
后退，指数重试 |
quota_exceeded |
每日免费限额 |
免费模特每日上限 |
添加积分或等待 24 小时 |
服务器（5xx）
| 代码 |
留言 |
原因 |
行动 |
内部错误 |
内部服务器错误 |
无限虫子 |
重试；联系支持人员并提供请求 ID |
上游错误 |
提供商错误 |
模型提供商问题 |
重试；检查状态页面 |
超载 |
服务超载 |
高负载 |
后退重试 |
重试指导
| 错误 |
重试？ |
退避 |
| 429 |
429是的 |
指数：1 秒、2 秒、4 秒……最长 60 秒 |
| 502、503、529 |
是的 |
1-5 次重试，出现抖动 |
| 400、401、402、403 |
没有 |
首先修复请求 |
| 500 |
500是的 |
重试 1-2 次，然后支持 |
零令牌计费
在以下情况下，您不会被收取费用：
- 请求在提供商处理之前失败（4xx，除非另有说明）
- 提供者返回错误且完成标记为零
- 请求超时且没有消耗令牌
在以下情况下，您需要付费：
- 提供者返回令牌（即使输出是空字符串且完成令牌 > 0）
获取帮助
包含在支持请求中：
- 响应中的“x-request-id”标头（如果存在）
- 时间戳（UTC）
- 型号名称
- HTTP状态和错误代码
- 仅 API 密钥前缀（前 8 个字符）
support@boundlessapi.com
内部指南：error-codes-support-guide.md