Nano Banana 2.1 API

Create images with Nano Banana 2.1 using text, images. Available resolutions: 1k / 2k / 4k. Try the current API settings, preview results and reuse your inputs.

Modalities

TextImageImage

Published

1kAbout 40% less than official

$0.02/ request

$0.0336 · official reference

2kAbout 20% less than official

$0.04/ request

$0.0504 · official reference

4kAbout 29% less than official

$0.08/ request

$0.113 · official reference

Input

API key for this model

Generation mode

Text to imageReference to image

Guide generation with the supported reference inputs below.

prompt *

images0 / 14

Upload

JPEG / PNG / WEBP · ≤ 10 MB

Add a reference before running in reference mode.

resolutionaspect ratiooutput formatground search

Request preview

{
  "model": "nano-banana2.1",
  "input": {
    "images": [],
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A quiet mountain lake at sunrise, soft morning light."
  }
}

Output

Your next idea starts here.

Run the model to preview your result.

Build with this model

The example follows your Playground parameters.

curl --request POST 'https://newrouters.com/v1/tasks' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer $MODEL_API_KEY" \
  --data '{
  "model": "nano-banana2.1",
  "input": {
    "images": [],
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A quiet mountain lake at sunrise, soft morning light."
  }
}'

Set MODEL_API_KEY in your environment. Keep your secret key on the server. Full documentation ↗

Nano Banana 2.1 pricing

Estimate one request, then choose a budget for your workflow.

Specification

Usage	Quantity	Rate	Cost
1k	1 request	$0.02/ request	$0.02

Cost per request$0.02

Public USD estimate. Your account rate and final recorded usage determine the actual charge.

View all specifications and prices

Specification	Our price	Official reference
1k	$0.02 / request	$0.0336 About 40% less than official
2k	$0.04 / request	$0.0504 About 20% less than official
4k	$0.08 / request	$0.113 About 29% less than official

Related models

Image models ↗

Model	Price	Resolution	Input → output
GoogleNano Banana 2.1Current	$0.02 / requestAbout 40% less than official	1k / 2k / 4k	TextImageImage
OpenAIGPT Image 2Both declare text, image inputSame billing units	$0.02 / requestAbout 62% less than official	1k / 2k / 4k	TextImageImage
OpenAIGPT Image 2.5 FlareBoth declare text, image inputSame billing units	$0.02 / request	1k / 2k / 4k	TextImageImage
OpenAIGPT Image 2.5 SunburstBoth declare text, image inputSame billing units	$0.02 / request	1k / 2k / 4k	TextImageImage
xAIGrok Imagine ImageBoth declare text, image inputSame billing units	$0.03 / request	1k / 2k	TextImageImage

Official source ↗ · 2026-10-14

Start with a prompt

Original prompts adapted to documented capabilities; use platform-supported parameters.

Consistent character editing

Place the original reference character in a full-body rainy street scene. Preserve facial traits, costume design and main colors; change only pose and setting.

Try this prompt ↗

Infographic design

Design an infographic showing four tea-brewing steps: warm the cup, add leaves, pour water and serve. Use readable labels with matching illustrations.

Try this prompt ↗

What is Nano Banana 2.1?

Create images with Nano Banana 2.1 using text, images. Available resolutions: 1k / 2k / 4k. Try the current API settings, preview results and reuse your inputs.

Nano Banana 2.1 improves visual quality, typography and multi-turn character consistency over Nano Banana 2.

Official model information ↗ · 2026-10-14

Nano Banana 2.1 specifications

Model ID	nano-banana2.1
Provider	Google
API	/v1/tasks
Resolution	1k / 2k / 4k
Aspect ratio	auto / 1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 4:5 / 5:4 / 9:16 / 16:9 / 21:9 / 1:4 / 1:8 / 4:1 / 8:1
Output format	png / jpeg / webp
Reference images	Up to 14

Before you generate

Use the current model ID and the API request shape shown on this page.
Generation is asynchronous. Keep the returned task ID to retrieve the result and billing status.
Only options supported by the current platform contract are exposed in Playground.

Compare Nano Banana 2.1 with related models

Specification	Nano Banana 2.1	GPT Image 2	GPT Image 2.5 Flare
Provider	Google	OpenAI	OpenAI
Input → output	TextImageImage	TextImageImage	TextImageImage
Selection basis	Current model	Both declare text, image input · Same billing units	Both declare text, image input · Same billing units
Resolution	1k / 2k / 4k	1k / 2k / 4k	1k / 2k / 4k
Reference images	14	20	20
Starting price	$0.02 / request	$0.02 / request	$0.02 / request

Choose by the input types, output settings and billing unit your workflow needs. Try the same prompt across models to compare results for your own use case.

BUILD WITH NEWROUTERS

Build with Nano Banana 2.1 in your app

Submit parameters through the Media Tasks API, then retrieve the result with the task ID. Image and video models keep their own input requirements.

01
Get your API key
Sign in and prepare a key with access to this model.
02
Configure your request
Choose parameters in Playground and copy the API example.
03
Run and inspect the result
Review status, outputs and charges in History.

Read the model API guide ↗

API integration

POST /v1/tasks · Authorization: Bearer

cURL

curl 'https://newrouters.com/v1/tasks' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MODEL_API_KEY" \
  --data '{
  "model": "nano-banana2.1",
  "input": {
    "images": [],
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "A quiet mountain lake at sunrise, soft morning light."
  }
}'

JavaScript

const response = await fetch("https://newrouters.com/v1/tasks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer $MODEL_API_KEY"
  },
  body: JSON.stringify({
    "model": "nano-banana2.1",
    "input": {
      "images": [],
      "resolution": "1k",
      "aspect_ratio": "auto",
      "output_format": "jpeg",
      "prompt": "A quiet mountain lake at sunrise, soft morning light."
    }
  })
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.text());

Python

import json
import requests

response = requests.post(
    "https://newrouters.com/v1/tasks",
    headers=json.loads("{\"Content-Type\":\"application/json\",\"Authorization\":\"Bearer $MODEL_API_KEY\"}"),
    json=json.loads("{\"model\":\"nano-banana2.1\",\"input\":{\"images\":[],\"resolution\":\"1k\",\"aspect_ratio\":\"auto\",\"output_format\":\"jpeg\",\"prompt\":\"A quiet mountain lake at sunrise, soft morning light.\"}}"),
    timeout=300,
)
response.raise_for_status()
print(response.text)

Poll the returned task ID for processing status and output assets.

curl -H "Authorization: Bearer $MODEL_API_KEY" "https://newrouters.com/v1/tasks/$TASK_ID"

Documentation: Authentication · Task status and results · Error handling

Full API parameters and combination constraints

Request parameters

Parameter	Type	Values & constraints
`images`	array	Default: []
`prompt` *	string
`resolution`	JSON	"1k" · "2k" · "4k"Default: "1k"
`aspect_ratio`	JSON	"auto" · "1:1" · "3:2" · "2:3" · "3:4" · "4:3" · "4:5" · "5:4" · "9:16" · "16:9" · "21:9" · "1:4" · "1:8" · "4:1" · "8:1"Default: "auto"
`ground_search`	boolean
`output_format`	JSON	"png" · "jpeg" · "webp"Default: "jpeg"

Full JSON Schema and combination constraints

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "images": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "default": [],
      "maxItems": 14
    },
    "prompt": {
      "type": "string",
      "maxLength": 100000,
      "minLength": 1
    },
    "resolution": {
      "enum": [
        "1k",
        "2k",
        "4k"
      ],
      "default": "1k"
    },
    "aspect_ratio": {
      "enum": [
        "auto",
        "1:1",
        "3:2",
        "2:3",
        "3:4",
        "4:3",
        "4:5",
        "5:4",
        "9:16",
        "16:9",
        "21:9",
        "1:4",
        "1:8",
        "4:1",
        "8:1"
      ],
      "default": "auto"
    },
    "ground_search": {
      "type": "boolean"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "default": "jpeg"
    }
  },
  "additionalProperties": false
}

Nano Banana 2.1 API · Common questions

Answers about pricing, inputs, integration and results.

How much does Nano Banana 2.1 cost?

The current public price starts at $0.02 / request. The pricing section lists each specification. Playground checks your account price before submitting; the completed request records the final charge.

How do I get a NewRouters API key?

Sign in and open Quick Start above the workspace. Select or create a key with access to this model, then copy the request example.

Which inputs and output settings are supported?

Supported input fields: images, prompt, resolution, aspect_ratio, ground_search, output_format. The parameter table includes allowed values and defaults.

Can I use reference images?

Yes. Use the reference mode to upload images or supply their URLs. The current limit is 14 images. Reference images guide a new generation; they do not imply mask editing support.

How do I retrieve results and past requests?

Save the returned task ID and query the task until it succeeds or fails. The History tab lets you reopen your tasks and reuse their parameters.

What happens if the model is closed?

The model keeps its page and identity, but new generation requests are blocked. Existing task records remain accessible. An upstream outage is reported separately from an administrator closing the model.

Read the API documentation ↗

Discover more AI tools

Browse all models ↗

Integration topics / Documentation

All documentation ↗

IMAGEHello, API.

Docs: Choose image specifications and references

Check resolution, aspect ratio, format and reference constraints.

View docs section ↗

BUDGET/v1/tasks

Docs: Batch tasks and budgets

Estimate using the actual specification and billing unit; reconcile task charges.

View docs section ↗

WORKFLOW{ your next idea }

Docs: Image and video task learning path

Understand asynchronous states, result URLs and safe recovery.

View docs section ↗

Nano Banana 2.1 API

Build with this model

Nano Banana 2.1 pricing

Start with a prompt

Consistent character editing

Infographic design

What is Nano Banana 2.1?

Nano Banana 2.1 specifications

Before you generate

Compare Nano Banana 2.1 with related models

Build with Nano Banana 2.1 in your app

API integration

Request parameters

Nano Banana 2.1 API · Common questions

How much does Nano Banana 2.1 cost?

How do I get a NewRouters API key?

Which inputs and output settings are supported?

Can I use reference images?

How do I retrieve results and past requests?

What happens if the model is closed?

Discover more AI tools

AI image generator

AI video generator

AI chat API

API documentation

Integration topics / Documentation

Docs: Choose image specifications and references

Docs: Batch tasks and budgets

Docs: Image and video task learning path