Bambuk 错误处理
根据 HTTP 状态、错误码和请求标识定位问题。
错误结构
{
"code": "AUTH_INVALID_CREDENTIALS",
"message": "Invalid credentials",
"request_id": "请求标识",
"timestamp": 1790000000
}调用链中的代理也可能返回纯文本或 HTML 错误。程序应先检查 HTTP 状态和 Content-Type，不对所有失败响应强行解析 JSON。
常见错误
| HTTP | 错误码 | 建议处理 |
|---|---|---|
| 400 | VALIDATION_ERROR | 检查参数类型、字段名和文件上传方式 |
| 401 | AUTH_INVALID_CREDENTIALS / AUTH_TOKEN_EXPIRED | 检查 Key 或刷新 Token |
| 403 | AUTH_FORBIDDEN / AUTH_KEY_REVOKED | 检查应用状态与接口授权 |
| 403 | QUOTA_EXCEEDED | 检查套餐有效期和剩余额度 |
| 404 | ENDPOINT_NOT_FOUND / RESOURCE_NOT_FOUND | 检查路径和模型启用状态 |
| 429 | RATE_LIMIT_EXCEEDED | 降低请求速度，等待后再提交 |
| 500 | INTERNAL_ERROR | 保留请求标识并联系平台管理员 |
| 502 / 503 / 504 | 平台网关或模型服务暂时不可用 | 核对请求是否已执行，避免自动重复调用 |
实际模型错误可能经网关转换为 SERVICE_UNAVAILABLE。请结合 message 和请求标识定位，不依赖某一条错误文案做业务判断。
排查顺序
- 对照文档检查 URL、HTTP 方法和 Content-Type。
- 检查凭证是否属于开放平台，而不是模型网关。
- 确认套餐、接口和应用均可用。
- 核对文件大小、编码、源语言与模型能力。
- 记录响应的
request_id或X-Request-ID，在控制台查看使用记录。
记录排障信息时隐藏凭证、个人数据和完整上传内容。