快速开始
用几次请求创建第一个 Buble API 生成任务。
快速开始
这个指南会创建一个文生图任务，然后轮询结果。
1. 设置 API Key
export BUBLE_API_KEY="sk_your_api_key"API Key 只应该在服务端使用，不要暴露在浏览器代码中。
2. 查看可用模型
curl https://buble.ai/api/v1/models \
-H "Authorization: Bearer $BUBLE_API_KEY"从响应中选择 model，并使用它的 operations[].mode。
3. 创建文生图任务
curl https://buble.ai/api/v1/generations \
-H "Authorization: Bearer $BUBLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-pro",
"mode": "text_to_image",
"prompt": "A premium product photo of a matte black wireless speaker on a marble table, cinematic studio lighting",
"aspect_ratio": "1:1",
"resolution": "1K",
"output_format": "png"
}'响应会返回生成任务 id。
4. 轮询任务
curl https://buble.ai/api/v1/generations/YOUR_GENERATION_ID \
-H "Authorization: Bearer $BUBLE_API_KEY"持续轮询，直到 data.status 变为 success 或 failed。
5. 需要素材时先上传文件
图生图或图生视频工作流通常需要先上传源文件：
curl https://buble.ai/api/v1/files \
-H "Authorization: Bearer $BUBLE_API_KEY" \
-F "file=@./reference.png" \
-F "file_type=image" \
-F "model=google/nano-banana-pro" \
-F "mode=image_to_image"然后把返回的 data.url 传给所选 mode 支持的 image_urls、start_frame 等字段。