错误处理

Buble API 使用统一错误响应格式。

错误格式

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid or inactive API key.",
    "details": {}
  }
}

只有存在额外结构化信息时才会返回 details。

Code	HTTP	含义	处理方式
`invalid_request_body`	400	JSON 请求体无效或字段类型不匹配。	校验请求字段和类型。
`unsupported_field`	400	传入了嵌套结构或内部字段。	移除 `input`、`options`、`scene`、`sub_mode_id`、provider、media type 和内部媒体字段。
`missing_file`	400	上传请求缺少 `file` 字段。	添加 `file` 表单字段。

Code	HTTP	含义	处理方式
`model_not_found`	404	模型不可用。	使用 `/api/v1/models` 返回的模型 key。
`model_not_api_configured`	422	模型没有公开 API 配置。	选择其他 API 可用模型。
`mode_not_supported`	422	当前模型不存在该 mode。	使用 `/api/v1/models` 的 `operations[].mode`。
`mode_not_api_configured`	422	mode 存在但没有公开 endpoint。	使用列表中的其他 operation。
`unsupported_input_for_model`	422	输入形态不受支持。	查看该模型 mode 的输入要求。
`ambiguous_generation_mode`	422	输入同时匹配多个 mode。	显式传入 `mode`。
`mode_scene_missing`	422	mode 缺少内部场景映射。	联系支持，这是配置问题。