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": {}
}
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.