Skip to main content
POST
Nano Banana 2 (image edit)
Edit images using the Gemini 3.1 Flash model with natural language prompts. Supports both URL and Base64 encoded images as input, with up to 14 reference images.

Request Headers

string
required
Enum: application/json
string
required
Bearer authentication format: Bearer {{API Key}}.

Request Body

string
default:"1K"
Output image pixel dimensions. 0.5K (~512px), 1K (~1024px), 2K (~2048px), 4K (~4096px). Defaults to 1KPossible values: 0.5K, 1K, 2K, 4K
object
Google search options
string
required
Text prompt describing the desired image editing effect
array
List of input image URLs for editing, up to 14 reference images supportedArray length: 0 - 14
string
Aspect ratio of the output image. Supports standard ratios and additional ultra-wide/ultra-tall ratios (1:4, 4:1, 1:8, 8:1)Possible values: 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9
array
List of Base64 encoded images for editing. Combined total of image_urls and image_base64s must not exceed 14Array length: 0 - 14
string
default:"image/png"
MIME type of the output image. Supported formats: image/png, image/jpeg. Defaults to image/pngPossible values: image/png, image/jpeg

Response

array
required
List of edited image URLs
object
Model grounding metadata. Returned when Google server-side tools (e.g., search) are invoked. Note: tool invocation depends on Google. Enabling the parameter makes the tool available but does not guarantee 100% tool invocation.