SandBase is live — $1 in free credits on signupStart free ›
Start building
Use in agentGoogle models

Google modelsimage generation api

google/gemini-2.5-flash-image/edit

Gemini 2.5 Flash Image Edit is Google's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.

Input
The prompt for image editing.

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

The URLs of the images to use for image-to-image generation or image editing.
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.
The seed for the random number generator.
The format of the generated image. Allowed values: jpeg, png.
Idle

Example output — click Run to generate your own

API README

Gemini 2.5 Flash Image Edit

Google Gemini 2.5 Flash Image Edit revises existing visuals through a text prompt. Its documented editing range includes focused background replacement as well as broader artistic style conversion. One or more supplied images can carry subjects, compositions, and visual references into the transformation, while the prompt explains what should change.

The endpoint supports conversational image editing and accepts prompts up to 50,000 characters, giving detailed briefs ample room. Ten aspect ratios help adapt the revised composition to different placements, while JPEG or PNG output and a seed support practical delivery and repeatable comparisons.

Highlights

Conversational image editing. Describe the desired revision in ordinary language while existing images anchor the visual result.

Practical and expressive changes. Replace a background for production work or reinterpret the asset in a different artistic style.

Multiple image inputs. Bring several visuals into one edit when the brief depends on more than a single reference.

Flexible final assets. Select among ten aspect ratios, export JPEG or PNG, and retain a seed for comparable reruns.

Pricing

Billing unitPrice
Per request$0.04

When to Use

✅ Good fit❌ Consider alternatives
The model's named workflow matches the source material and intended outputA different input modality or model route is required
A managed asynchronous result is suitable for the production pipelineA synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or formatThe project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structureExact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverableEditable source layers or a native project file are required

Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "aspect_ratio": "21:9",
  "images": [
    "https://static.sandbase.ai/examples/google/gemini-2.5-flash-image/edit/input_images_0.png"
  ],
  "output_format": "png",
  "prompt": "make a photo of the man driving the car down the california coastline"
}

Technical Specs

SpecValue
Model IDgoogle/gemini-2.5-flash-image/edit
Inputsaspect_ratio, images, output_format, prompt, seed
Required inputsprompt
Output fieldscontent_type, url
ExecutionAsync (submit, then poll for result)
Aspect Ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16
Output Formatjpeg / png

Related Models

Related Models

google/imagen-3Imagen 3 by Google - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.google/imagen-3/fastImagen 3 Fast is Google's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.google/imagen-4/previewImagen 4 Preview by Google - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.google/imagen-4/preview/fastImagen 4 Preview Fast is Google's advanced text-to-image AI model. Create photorealistic images, illustrations, and concept art from natural language descriptions with exceptional detail and prompt adherence.google/imagen-4/preview/ultraImagen 4 Preview Ultra by Google - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.google/nano-bananaGoogle's famous original image generation and editing model.google/nano-banana-2Nano Banana 2 is Google's new state-of-the-art fast image generation and editing modelgoogle/nano-banana-2-liteNano Banana 2 Lite by Google - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.