错误 · Bitdeer AI

非 2xx 响应返回如下 JSON 结构：

429application/json— 触发限流

{
  "error": {
    "message": "Rate limit exceeded. Please retry after a brief wait.",
    "type": "rate_limit_exceeded",
    "param": null,
    "code": "rate_limited"
  }
}

HTTP 状态码

HTTP	可重试	含义
`400`	否	请求格式错误 — 查看 `error.message`
`401`	否	API Key 缺失或无效
`403`	否	权限或余额不足
`404`	否	资源不存在（如未知模型）
`429`	是	超过速率限制（默认 100 RPM）
`500`	否	服务端内部错误
`503`	是	服务暂时不可用

LLM 相关错误码

错误	状态	说明
`INVALID_API_KEY`	401	未提供或 API Key 无效
`MODEL_NOT_FOUND`	404	请求的模型不存在
`INVALID_REQUEST_BODY`	400	请求体格式错误
`RATE_LIMIT_EXCEEDED`	429	请求过频 — 稍后重试
`TOKEN_LIMIT_EXCEEDED`	429	Token 超限 — 稍后重试
`NOT_ENOUGH_BALANCE`	403	账户余额不足
`SERVICE_NOT_AVAILABLE`	503	服务暂时不可用

速率限制

所有端点默认 每分钟 100 次请求（RPM）。

超限后返回 HTTP 429 与 RATE_LIMIT_EXCEEDED 错误。

错误结构

error

messagestringrequired

人类可读的错误说明。

typestring

机器可读的错误类别。

codestring | null

便于程序处理的短码。

paramstring | null

若有，为出错请求字段名。

错误

HTTP 状态码

LLM 相关错误码

速率限制

错误结构

本页目录