Buble API
使用 Buble 的服务端 API 创建 AI 图片与视频生成任务。
Buble API
Buble API 用于从你自己的后端服务创建 AI 图片与视频生成任务。公开 API 保持克制：查询模型、上传文件、创建异步生成任务、轮询结果。
Base URL
https://buble.ai公开接口
| Method | Endpoint | 用途 |
|---|---|---|
GET | /api/v1/models | 查看可用于 API 的模型、公开 mode、输入和参数。 |
POST | /api/v1/files | 上传图片、视频或音频素材。 |
POST | /api/v1/generations | 创建异步生成任务。 |
GET | /api/v1/generations/[id] | 查询任务状态和结果素材。 |
核心工作流
- 使用
Authorization: Bearer $BUBLE_API_KEY鉴权。 - 从
GET /api/v1/models选择model和mode。 - 如果该 mode 需要素材输入，先上传文件。
- 创建生成任务。
- 轮询任务，直到状态变为
success或failed。
公开字段模型
Buble 的公开生成接口使用扁平 JSON：素材 URL 和模型参数都直接放在请求体根层级。
| 字段 | 含义 |
|---|---|
model | 稳定模型 key，例如 google/nano-banana-pro。 |
mode | 公开操作模式，例如 text_to_image 或 frames_to_video。 |
prompt | 生成指令。 |
image_urls、start_frame、end_frame、video_urls、audio_urls | 媒体输入类 mode 使用的源素材 URL。 |
| 模型参数 | /api/v1/models 返回的模型专属控制项，例如 duration、resolution、aspect_ratio、output_format。 |
不要传递 input、options，也不要传递 scene、sub_mode_id、provider、mediaType、media_type 等内部字段。Buble 会基于 model、mode 和扁平公开输入字段在服务端自动解析内部调用链路。