Buble API
Server-side API for creating AI image and video generations with Buble.
Buble API
The Buble API lets you create AI image and video generations from your own backend. The public API is intentionally small: discover models, upload files, create asynchronous generation tasks, and poll the result.
Base URL
https://buble.aiPublic endpoints
| Method | Endpoint | Purpose |
|---|---|---|
GET | /api/v1/models | List API-ready models, public modes, inputs, and parameters. |
POST | /api/v1/files | Upload image, video, or audio assets for generation inputs. |
POST | /api/v1/generations | Create an asynchronous generation task. |
GET | /api/v1/generations/[id] | Query task status and result media. |
Core workflow
- Authenticate with
Authorization: Bearer $BUBLE_API_KEY. - Pick a
modelandmodefromGET /api/v1/models. - Upload files first if the mode requires media input.
- Create a generation task.
- Poll the task until
successorfailed.
Public field model
Buble's public generation request is flat: put media URLs and model-specific controls directly in the JSON body.
| Field | Meaning |
|---|---|
model | Stable model key, for example google/nano-banana-pro. |
mode | Public operation, for example text_to_image or frames_to_video. |
prompt | Text instruction for the generation. |
image_urls, start_frame, end_frame, video_urls, audio_urls | Source media URLs for media-input modes. |
| model options | Model-specific controls returned by /api/v1/models, such as duration, resolution, aspect_ratio, or output_format. |
Do not send input, options, or internal implementation fields such as scene, sub_mode_id, provider, mediaType, or media_type. The API rejects these fields because Buble resolves them server-side from model, mode, and the flat public input fields.