Skip to main content
POST
/
v3
/
gemini-3.1-flash-image-edit
Nano Banana 2 (image edit)
curl --request POST \
  --url https://api.myrouter.ai/v3/gemini-3.1-flash-image-edit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "size": "<string>",
  "google": {
    "web_search": true,
    "image_search": true
  },
  "prompt": "<string>",
  "image_urls": [
    {}
  ],
  "aspect_ratio": "<string>",
  "image_base64s": [
    {}
  ],
  "output_format": "<string>"
}
'
{
  "image_urls": [
    {}
  ],
  "grounding_metadata": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.myrouter.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Content-Type
string
required
Enum: application/json
​
Authorization
string
required
Bearer authentication format: Bearer {{API Key}}.

​
Request Body

​
size
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
​
google
object
Google search options
​
prompt
string
required
Text prompt describing the desired image editing effect
​
image_urls
array
List of input image URLs for editing, up to 14 reference images supportedArray length: 0 - 14
​
aspect_ratio
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
​
image_base64s
array
List of Base64 encoded images for editing. Combined total of image_urls and image_base64s must not exceed 14Array length: 0 - 14
​
output_format
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

​
image_urls
array
required
List of edited image URLs
​
grounding_metadata
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.