常见报错码
调用 API 时可能遇到 HTTP 错误或业务错误。下表汇总最常见情况。
HTTP 状态码
| 代码 | 含义 | 处理建议 |
|---|---|---|
400 | 请求参数错误 | 检查 JSON 格式、模型名、必填字段 |
401 | 鉴权失败 | 检查 Key 是否正确、是否带 Bearer |
403 | 无权限或余额不足 | 检查账户余额、令牌额度、模型权限 |
404 | 路径或资源不存在 | 检查 URL 是否为 https://bigbangtoken.com/v1/... |
413 | 请求体过大 | 缩短 prompt 或减少上传文件大小 |
429 | 请求过于频繁 | 降低并发,稍后重试 |
500 | 服务端或上游异常 | 稍后重试,持续失败联系客服 |
503 | 服务暂不可用 | 等待恢复或更换分组/模型 |
业务层常见提示
| 提示 | 可能原因 |
|---|---|
| 当前分组下没有可用渠道 | 模型名错误或分组无该模型 |
| 该令牌额度已用尽 | 令牌额度用完,需追加额度 |
| user quota is not enough | 账户钱包余额不足 |
| max_tokens is too large | max_tokens 超过模型上限 |
| 无可用渠道 | 模型不存在或未授权 |
排查顺序
- Base URL 是否为
https://bigbangtoken.com/v1 - 模型名是否与 价格页 完全一致
- 令牌与账户是否仍有额度
- 令牌分组是否包含目标模型
更多 FAQ 见 常见错误及解决。