Google modelsimage generation api

google/nano-banana-pro/edit

Name: Nano Banana Pro Image Editing
Author: Google

Nano Banana Pro is Google's new state-of-the-art image generation and editing model

Input

Image URL or upload(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

The URLs of the images to use for image-to-image generation or image editing.

Prompt(string)

The text prompt to generate an image from.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png.

Resolution(string)

The resolution of the image to generate. Allowed values: 1K, 2K, 4K.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDgoogle/nano-banana-pro/edit

Input Schema

5 parameters · 2 required · 3 optional

Parameter	Type	Required	Description
`images`	string[]	Required	The URLs of the images to use for image-to-image generation or image editing.
`prompt`	string	Required	The text prompt to generate an image from. · Min length: 3 · Max length: 50000 · Default: "Create a professional e-commerce fashion photo. Take the blue floral dress from the first image and let the woman from the second image wear it. Generate a realistic, full-body shot of the woman wearing the dress, with the lighting and shadows adjusted to match the outdoor environment."
`resolution`	string	Optional	The resolution of the image to generate. · Options: 1K, 2K, 4K · Default: "1K" 1K2K4K
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "google/nano-banana-pro/edit",
  "images": [
    "https://ai.google.dev/static/gemini-api/docs/images/dress.png",
    "https://ai.google.dev/static/gemini-api/docs/images/model.png"
  ],
  "prompt": "Create a professional e-commerce fashion photo. Take the blue floral dress from the first image and let the woman from the second image wear it. Generate a realistic, full-body shot of the woman wearing the dress, with the lighting and shadows adjusted to match the outdoor environment.",
  "resolution": "1K",
  "output_format": "png"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Nano Banana Pro Image Editing

API README

Google Nano Banana Pro Image Editing

Precision image editing powered by Google's Nano Banana Pro model. Modify existing images with natural language instructions — swap outfits, combine subjects, change backgrounds, or restyle elements — while preserving quality and coherence.

Need to generate from scratch? Try Nano Banana Pro.

Highlights

Multi-image synthesis — Accepts up to 14 reference images in a single request. Combine product photos, merge elements from different sources, or apply styles from one image to another.

Context-aware editing — Understands spatial relationships and visual context. Edits blend naturally with the original image, maintaining lighting consistency, perspective, and material textures.

Reference-driven generation — Use input images as style guides, subject references, or composition templates. The model extracts relevant features and applies them intelligently to the output.

Cost-efficient — $0.12 per edit (1K/2K), $0.24 for 4K. Competitive pricing regardless of the number of input images.

Pricing

Resolution	Price
1K	$0.12
2K	$0.12
4K	$0.24

When to Use

✅ Good fit	❌ Consider alternatives
Virtual try-on (clothing on models)	Generating images from zero (use Generation model)
Product photo background swaps	Pixel-perfect mask control
Combining multiple items into one scene	Real-time interactive editing
Style transfer across images	Video frame manipulation
E-commerce product visualization	Simple crops or color adjustments

Input Requirements

Images provided as publicly accessible URLs
Supported formats: PNG, JPEG, WebP
Up to 14 images per request
For best results: use consistent lighting and resolution across input images

Technical Specs

Spec	Value
Input	Text prompt + 1–14 image URLs
Output	PNG or JPEG
Resolution	1K / 2K / 4K
Aspect ratio	Matches input or specified
Execution	Async (submit → poll for result)
Typical latency	25–50 seconds

Nano Banana Pro — Text-to-image generation from scratch