Nano Banana 2.1

Model id nano-banana-2.1 · Google · image · 2 modes: text-to-image, image-to-image.

This page reflects the current catalog. Inputs, allowed values, limits and prices can change as the model evolves; the field names and their meaning do not. For the exact schema at any time, your agent calls get_model with the mode.

Text To Image

Mode text-to-image. Text to image.

Input

Field	Type	Required	Allowed	Description
`prompt`	string	Yes	up to 50,000 characters	What the image should show, or, when editing, the changes to make to the reference images.
`num_images`	integer		1 to 4	How many images to generate in one call.
`output_format`	string		`jpeg`, `png`, `webp`	File format of the generated images.
`aspect_ratio`	string		`auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `4:1`, `1:4`, `8:1`, `1:8`	Width-to-height ratio of the generated images.
`resolution`	string		`1K`, `2K`, `4K`	Output resolution. Higher resolutions cost more per image.

Pricing

1.94–6.48 credits per image by resolution. Fixed price: charged as estimated. For the exact price of a request, use estimate_generation.

Example

The arguments of generate_media:

{
  "model": "nano-banana-2.1",
  "mode": "text-to-image",
  "input": {
    "prompt": "Studio photo of a ceramic mug with steam, soft morning light",
    "aspect_ratio": "21:9",
    "resolution": "1K"
  }
}

Image To Image

Mode image-to-image. Edit or combine reference images.

Input

Field	Type	Required	Allowed	Description
`prompt`	string	Yes	up to 50,000 characters	What the image should show, or, when editing, the changes to make to the reference images.
`num_images`	integer		1 to 4	How many images to generate in one call.
`output_format`	string		`jpeg`, `png`, `webp`	File format of the generated images.
`aspect_ratio`	string		`auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`, `4:1`, `1:4`, `8:1`, `1:8`	Width-to-height ratio of the generated images.
`resolution`	string		`1K`, `2K`, `4K`	Output resolution. Higher resolutions cost more per image.
`references`	File list	Yes	1 to 14 items	References the output must follow. The kind of each one (image, video, audio) is read from the file; per-kind limits are in the mode’s `capabilities.references`.

References: up to 14: 14 images. Assets, URLs and elements are accepted.

Pricing

1.94–6.48 credits per image by resolution. Fixed price: charged as estimated. For the exact price of a request, use estimate_generation.

Example

The arguments of generate_media:

{
  "model": "nano-banana-2.1",
  "mode": "image-to-image",
  "input": {
    "prompt": "Studio photo of a ceramic mug with steam, soft morning light, keeping the look of the reference",
    "aspect_ratio": "21:9",
    "resolution": "1K",
    "references": [
      "asset_91a3c7e5b2d84f6a8e0c1b9d7f3a5e24"
    ]
  }
}

Models

Video

Image

Audio

Nano Banana 2.1

Text To Image

Input

Pricing

Example

Image To Image

Input

Pricing

Example

​Text To Image

​Input

​Pricing

​Example

​Image To Image

​Input

​Pricing

​Example

Text To Image

Input

Pricing

Example

Image To Image

Input

Pricing

Example