Models
Discover Buble models, public modes, input requirements, and generation parameters.
Models
Use GET /api/v1/models to discover which models can be called through the public API. The response is generated from the active model configuration and includes only API-ready modes.
Endpoint
GET /api/v1/modelsQuery parameters
| Name | Type | Required | Description |
|---|---|---|---|
media_type | string | No | Filter by image, video, or audio. |
Example request
curl "https://buble.ai/api/v1/models?media_type=image" \
-H "Authorization: Bearer $BUBLE_API_KEY"Response shape
{
"data": [
{
"model": "google/nano-banana-pro",
"name": "Nano Banana Pro",
"media_type": "image",
"operations": [
{
"mode": "text_to_image",
"description": "Generate images from a prompt.",
"input": {
"required": ["prompt"],
"optional": []
},
"parameters": [
{
"name": "aspect_ratio",
"type": "string",
"default": "1:1",
"enum": ["1:1", "16:9"],
"required": false
}
]
}
]
}
]
}Important fields
| Field | Description |
|---|---|
model | Use this value as the model field when creating a generation. |
operations[].mode | Use this value as the public mode field. |
operations[].input.required | Minimum public fields needed for the mode. |
operations[].parameters | Model-specific controls accepted at the request root. |
Why mode matters
A model may support multiple operations. For production requests, pass mode explicitly. If you omit it, Buble can infer the mode only when the input shape matches exactly one configured mode.