Image to Image API
Transform source images with Buble image-to-image models.
Image to Image API
Image-to-image workflows use mode: "image_to_image" and pass source image URLs through image_urls.
Workflow
- Upload one or more source images with
POST /api/v1/files. - Pass the returned URLs to
image_urls. - Poll the generation result.
Example
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": "image_to_image",
"prompt": "Turn this room into a warm Japandi interior with oak furniture, linen textures, soft daylight, and a calm premium editorial look",
"image_urls": ["https://example.com/source-room.png"],
"aspect_ratio": "16:9",
"resolution": "1K",
"output_format": "png"
}'Model input limits
| Model | Max source images | Formats | Max size |
|---|---|---|---|
google/nano-banana | 10 | jpg, png, webp, bmp, gif | 30 MB |
google/nano-banana-pro | 8 | jpg, jpeg, png, webp | 30 MB |
openai/gpt-image-2 | 16 | jpg, png, webp | 10 MB |