edit_image
Describe desired changes to edit images using AI. Adjust style, background, add or remove elements, enhance quality.
Instructions
Edit or transform images using Nano Banana Pro Edit API.
This tool applies AI-powered edits to existing images based on text descriptions.
You can adjust style, add/remove elements, change backgrounds, enhance quality, etc.
Args:
prompt: Description of desired edits or transformations. Be specific about
what changes you want (e.g., "change background to sunset", "add studio
lighting", "remove watermark", "enhance colors").
image_urls: List of 1-10 publicly accessible image URLs to edit.
Images must be reachable via HTTP/HTTPS. Common formats supported: JPEG, PNG, WebP.
resolution: Output resolution. Options:
- "1k": Lower resolution, faster processing ($0.14)
- "2k": Standard resolution, best value ($0.14) [default]
- "4k": High resolution for detailed work ($0.24)
aspect_ratio: Output aspect ratio (optional). If not specified, maintains original.
Options: "1:1" (square), "16:9" (landscape), "9:16" (portrait), "3:2", "2:3",
"4:3", "3:4", "4:5", "5:4", "21:9"
output_format: Output file format. Options:
- "jpeg": Smaller file size, good for photos (default)
- "png": Lossless quality, good for graphics
enable_base64_output: Return base64-encoded image data instead of URL.
Default: false (return URL)
enable_sync_mode: Enable synchronous mode for immediate processing.
Default: false (asynchronous processing)
max_wait_seconds: Maximum time to wait for job completion in seconds.
Default: 300 (5 minutes)
Returns:
Success message with edited image URL, resolution, cost, and job ID.
Format: "✓ Image edited successfully!URL: ... Resolution: ... Cost: $... Job ID: ..."
Examples:
- "Add dramatic sunset lighting to this portrait"
- "Remove background and replace with solid white"
- "Enhance colors and increase sharpness for product photography"
- "Transform into oil painting style while keeping the subject"Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | Yes | ||
| image_urls | Yes | ||
| resolution | No | 2k | |
| aspect_ratio | No | ||
| output_format | No | jpeg | |
| enable_base64_output | No | ||
| enable_sync_mode | No | ||
| max_wait_seconds | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |