← All models
Generate and edit images with Google's Nano Banana 2 (Gemini 3.1 Flash Image). Fast, high-quality image generation with multi-image reference support, conversational editing, and 14 aspect ratios.
images
Details
- Accepts
- text + image
Pricing
- Input
- 62.5 cr / 1M tokens
- Output
- 7500 cr / 1M tokens
Prices in credits (1 credit = $0.01).
Data schema
approximateInput
| Field | Type | Description |
|---|---|---|
| n | integer | How many images to generate. |
| mask | string | Optional mask for the edit; transparent pixels mark the area to change. |
| image | string | Image to edit — a URL, a data URI, or an artifact reference. Supplying one turns the call into an edit. |
| promptrequired | string | The text prompt. Describes the image to generate, or the change to make when an image is supplied. |
| image_size | string | Requested output size. |
| aspect_ratio | string | Aspect ratio of the result, e.g. 16:9. |
| output_format | string | Encoding of the returned image. |
| resolution | —enum: 1K, 2K, 4K | Resolution of the generated image. Higher resolutions take longer to generate. |
| image_input | array | Input images to transform or use as reference (supports up to 14 images) |
| image_search | boolean | Use Google Image Search grounding to find web images as visual context for generation. When enabled, web search is also used automatically. |
| google_search | boolean | Use Google Web Search grounding to generate images based on real-time information (e.g. weather, sports scores, recent events). |
| seed | — | The seed for the random number generator. |
| pdf_url | — | Optional PDF document to use as input context. Accepts an http(s)/data URL (downloaded and sent inline, max 15MB). |
| audio_url | — | Optional audio file to use as input context. Accepts an http(s)/data URL (downloaded and sent inline, max 15MB). |
| sync_mode | boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
| video_url | — | Optional video to use as input context. Accepts an http(s)/data URL to a video file (downloaded and sent inline, max 15MB) or a YouTube URL (passed through to the model without downloading). |
| image_urls | array | The URLs of the images to use for image-to-image generation or image editing. Optional when at least one of `video_url`, `audio_url`, or `pdf_url` is provided. |
| num_images | integer | The number of images to generate. |
| system_prompt | string | Optional system instruction that steers the model's persona and output style across the request. Leave blank to omit; when provided, it is sent as the system instruction to Gemini (or as a system message on OpenAI-compatible providers). |
| thinking_level | — | When set, enables model thinking with the given level ('minimal' or 'high') and includes thoughts in the generation. Omit to disable. |
| safety_tolerance | stringenum: 1, 2, 3, 4, 5, 6 | The safety tolerance level for content moderation. 1 is the most strict (blocks most content), 6 is the least strict. |
| enable_web_search | boolean | Enable web search for the image generation task. This will allow the model to use the latest information from the web to generate the image. |
| limit_generations | boolean | Experimental parameter to limit the number of generations from each round of prompting to 1. Set to `True` to to disregard any instructions in the prompt regarding the number of images to generate and ignore any intermediate images generated by the model. This may affect generation quality. |
Output
| Field | Type | Description |
|---|---|---|
| images | array | Generated images ([{ url }]). |