Skip to main content
POST
/
v3
/
gemini-3-pro-image-edit
Gemini 3 Pro Image Editing
curl --request POST \
  --url https://api.highwayapi.ai/v3/gemini-3-pro-image-edit \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "size": "<string>",
  "google": {
    "web_search": true
  },
  "prompt": "<string>",
  "image_urls": [
    {}
  ],
  "aspect_ratio": "<string>",
  "image_base64s": [
    {}
  ]
}
'
{
  "image_urls": [
    {}
  ],
  "grounding_metadata": {}
}
Gemini 3 Pro Image (Nano Banana Pro) is designed to solve the most challenging image generation tasks by integrating state-of-the-art reasoning capabilities. It is the best model for handling complex and multi-turn image generation and editing, with higher accuracy and better image quality. It supports images encoded as URLs and Base64 as input.

Request Headers

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

Request Body

size
string
default:"1K"
Pixel size of the output image. 1K (1024px), 2K (2048px), 4K (4096px). Defaults to 1KOptional values: 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
aspect_ratio
string
Aspect ratio of the output imageOptional values: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
image_base64s
array
List of Base64-encoded images for editing

Response Information

image_urls
array
required
List of edited image URLs
grounding_metadata
object
Model grounding metadata. Returned when Google server-side tools (such as Search) are called. Note: tool invocation depends on Google. Enabling the parameter does not guarantee that a tool call will be triggered 100% of the time.