模型列表
查询 Buble 模型、公开 mode、输入要求和生成参数。
模型列表
使用 GET /api/v1/models 查询哪些模型可以通过公开 API 调用。响应基于当前激活的模型配置生成，并且只返回已经配置公开 API 的 mode。
Endpoint
GET /api/v1/models查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
media_type | string | 否 | 按 image、video 或 audio 过滤。 |
请求示例
curl "https://buble.ai/api/v1/models?media_type=image" \
-H "Authorization: Bearer $BUBLE_API_KEY"响应结构
{
"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
}
]
}
]
}
]
}关键字段
| 字段 | 说明 |
|---|---|
model | 创建生成任务时传入的 model。 |
operations[].mode | 创建生成任务时传入的公开 mode。 |
operations[].input.required | 当前 mode 最少需要的公开字段。 |
operations[].parameters | 当前 mode 支持、并可直接放在请求体根层级的生成参数。 |
为什么建议显式传 mode
一个模型可能支持多个操作。生产环境建议显式传 mode。如果省略，Buble 只有在输入形态唯一匹配某个 mode 时才会自动推断。