Nano Banana 2 API

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

Modalities

TextImageImage

Published

1kAbout 55% less than official

$0.03/ request

$0.067 · official reference

2kAbout 60% less than official

$0.04/ request

$0.101 · official reference

4kAbout 60% less than official

$0.06/ request

$0.151 · 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

Upload

JPEG / PNG / WEBP · ≤ 10 MB

Add a reference before running in reference mode.

resolutionaspect ratiooutput format

Request preview

{
  "model": "nano-banana2",
  "input": {
    "images": [],
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "Premium product editorial for an imaginary ceramic fragrance bottle named AER, warm limestone pedestal, precise soft shadow, quiet-luxury art direction, restrained cream and cobalt palette, clean studio photography, no existing brands or logos."
  }
}

Output

Example output

Open original ↗

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",
  "input": {
    "images": [],
    "resolution": "1k",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "prompt": "Premium product editorial for an imaginary ceramic fragrance bottle named AER, warm limestone pedestal, precise soft shadow, quiet-luxury art direction, restrained cream and cobalt palette, clean studio photography, no existing brands or logos."
  }
}'

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

Nano Banana 2 pricing

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

Specification

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

Cost per request$0.03

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.03 / request	$0.067 About 55% less than official
2k	$0.04 / request	$0.101 About 60% less than official
4k	$0.06 / request	$0.151 About 60% less than official

Related models

Image models ↗

Model	Price	Resolution	Input → output
GoogleNano Banana 2Current	$0.03 / requestAbout 55% 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.03 / request	1k / 2k / 4k	TextImageImage
OpenAIGPT Image 2.5 SunburstBoth declare text, image inputSame billing units	$0.03 / request	1k / 2k / 4k	TextImageImage
GoogleNano Banana ProBoth declare text, image inputSame billing units	$0.06 / requestAbout 55% less than official	1k / 2k / 4k	TextImageImage

See what it can create.

Existing examples generated through the platform, with original media and prompts.

Quiet-luxury product editorial

View prompt

Premium product editorial for an imaginary ceramic fragrance bottle named AER, warm limestone pedestal, precise soft shadow, quiet-luxury art direction, restrained cream and cobalt palette, clean studio photography, no existing brands or logos.

Original media ↗Try this prompt ↗

Typographic culture poster

View prompt

Contemporary cultural poster for a fictional exhibition titled TIDELINE, bold readable Latin typography, modular grid, deep ultramarine and warm coral, subtle paper grain, generous negative space, no real logos.

Original media ↗Try this prompt ↗

Cinematic architectural scene

View prompt

Cinematic coastal library at first light, weathered pale stone, shallow reflecting pool, a single person for scale, atmospheric haze, realistic architecture and believable materials.

Original media ↗Try this prompt ↗

Structured visual explainer

View prompt

Clear four-step visual explainer for a fictional circular packaging workflow: collect, clean, remake, return; accurate simple icons, readable short English labels, off-white background, forest green and amber accents.

Original media ↗Try this prompt ↗

What is Nano Banana 2?

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

Describe the subject, composition, lighting and intended use in your prompt. Add reference images when you want to guide the subject or visual style. Choose only the resolution, aspect ratio and output options listed in the current contract; inspect the result before reusing it in your product.

Nano Banana 2 specifications

Model ID	nano-banana2
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	Supported; see input validation

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 with related models

Specification	Nano Banana 2	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	Supported	20	20
Starting price	$0.03 / request	$0.02 / request	$0.03 / 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 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.

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",
  "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",
    "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\",\"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"
`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",
        "format": "uri"
      },
      "default": []
    },
    "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"
    },
    "output_format": {
      "enum": [
        "png",
        "jpeg",
        "webp"
      ],
      "default": "jpeg"
    }
  },
  "additionalProperties": false
}

Nano Banana 2 API · Common questions

Answers about pricing, inputs, integration and results.

How much does Nano Banana 2 cost?

The current public price starts at $0.03 / 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, 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. 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 ↗

QUICK STARTHello, API.

Docs: From API key to your first request

Set up authentication, select a model and run your first request.

View docs section ↗

MEDIA API/v1/tasks

Docs: Create tasks and retrieve outputs

Understand task states, output URLs and the generation lifecycle.

View docs section ↗

INTEGRATION{ your next idea }

Docs: Choose your first request endpoint

Choose the right endpoint and verify current models and parameters.

View docs section ↗

Nano Banana 2 API

Build with this model

Nano Banana 2 pricing

See what it can create.

Quiet-luxury product editorial

Typographic culture poster

Cinematic architectural scene

Structured visual explainer

What is Nano Banana 2?

Nano Banana 2 specifications

Before you generate

Compare Nano Banana 2 with related models

Build with Nano Banana 2 in your app

API integration

Request parameters

Nano Banana 2 API · Common questions

How much does Nano Banana 2 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: From API key to your first request

Docs: Create tasks and retrieve outputs

Docs: Choose your first request endpoint