Nano Banana 2 API: settings, cost and integration

Read in Russian

Published: Oct 24, 2026, 3:47 AM UTC · Updated: Oct 24, 2026, 3:47 AM UTC

Exact ID: gemini-3.1-flash-image. Check access for your key using GET /v1/models; a published model does not guarantee access for every account.

Prices and billing units

API429 catalog generated Oct 24, 2026, 5:33 AM UTC. The table shows direct request components; other general catalog metrics are not added here. Display prices are rounded to six decimal places; calculations use exact catalog rates. The calculator below follows the direct Images request contract. Sources checked: Oct 24, 2026.

Google Standard: $0.50 per 1M input tokens, $3 per 1M text/thinking output tokens and $60 per 1M image tokens. The calculator compares the output component; a complete native request may include additional components. Pricing sources are listed below. Batch, cache and special modes are kept separate from the base comparison.

Image generation budget

Specifications and compatibility boundaries

• Native Google limits: 131,072 input tokens and 32,768 output tokens; these are separate limits, not a shared window or confirmed API429 limits.
• Google describes 0.5K/1K/2K/4K output and text with images; the API429 client contract lists resolution 1K/2K/4K. Native grounding, thinking and Batch are not promised through this method.
• Nano Banana 2 is the exact gemini-3.1-flash-image. Nano Banana Pro, Lite and 2.1 are other models; their properties cannot be transferred based on a family name.

Specification: Google, checked Oct 24, 2026. These are not verified effective API429 limits. Check native manufacturer parameters and capabilities separately for the client method.

Published capabilities for this exact ID: chat image_editing image_generation vision . A missing field is not evidence of a prohibition, but it does not establish compatibility.

Public model observations

Over the last 24 hours: mean successful response time — 64 s; service error rate — 4.6%. Data as of Oct 24, 2026, 5:35 AM UTC.

Source: public 24-hour statistics. The mean is neither a median nor a response time guarantee; it is not a quality assessment of the image.

First request: curl, Python, JavaScript

Set API429_API_KEY on the server and check the exact ID using GET https://gateway.api429.com/v1/models using the same Bearer key. Generation incurs a charge; there are no automatic retries. An uncertain timeout does not prove there was no charge.

The examples request one result and b64_json. curl saves JSON to image-response.json; Python and JavaScript decode the file after checking MIME by signature. When choosing url, first distinguish a hosted URL from a data URI. Check warnings, partial results, api429.outputs and api429.parameter_mismatches, if present.

curl

curl --fail-with-body https://gateway.api429.com/v1/images/generations \
  -H "Authorization: Bearer $API429_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.1-flash-image","prompt":"A product photograph of a ceramic cup on a light table; soft daylight, no text.","n":1,"size":"1024x1024","response_format":"b64_json","resolution":"1K"}' \
  --output image-response.json

Python 3

import base64
import json
import os
import urllib.request
from pathlib import Path

key = os.environ["API429_API_KEY"]
base = "https://gateway.api429.com/v1"
headers = {"Authorization": "Bearer " + key, "Content-Type": "application/json"}
model = "gemini-3.1-flash-image"
with urllib.request.urlopen(urllib.request.Request(base + "/models", headers=headers), timeout=30) as response:
    available = {item["id"] for item in json.load(response)["data"]}
if model not in available:
    raise ValueError("Model unavailable to this key")
payload = json.loads("{\"model\":\"gemini-3.1-flash-image\",\"prompt\":\"A product photograph of a ceramic cup on a light table; soft daylight, no text.\",\"n\":1,\"size\":\"1024x1024\",\"response_format\":\"b64_json\",\"resolution\":\"1K\"}")
request = urllib.request.Request(base + "/images/generations",
    data=json.dumps(payload).encode("utf-8"), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
    result = json.load(response)
if result.get("warnings") or result.get("api429", {}).get("parameter_mismatches"):
    print("Inspect output warnings:", result.get("warnings"), result.get("api429"))
items = result.get("data", [])
if len(items) != 1 or not items[0].get("b64_json"):
    raise ValueError("Missing image or partial result; inspect before retrying")
raw = base64.b64decode(items[0]["b64_json"], validate=True)
if raw.startswith(b"\x89PNG\r\n\x1a\n"):
    extension = "png"
elif raw.startswith(b"\xff\xd8\xff"):
    extension = "jpg"
elif raw.startswith(b"RIFF") and raw[8:12] == b"WEBP":
    extension = "webp"
else:
    raise ValueError("Unknown image MIME; inspect before saving")
Path("image." + extension).write_bytes(raw)
print(result.get("api429", {}).get("outputs"))

JavaScript: Node.js 18+

import { writeFile } from "node:fs/promises";
const key = process.env.API429_API_KEY;
if (!key) throw new Error("Set API429_API_KEY");
const base = "https://gateway.api429.com/v1";
const headers = { Authorization: "Bearer " + key, "Content-Type": "application/json" };
const model = "gemini-3.1-flash-image";
const available = await fetch(base + "/models", { headers, signal: AbortSignal.timeout(30000) });
if (!available.ok) throw new Error("Models HTTP " + available.status);
if (!(await available.json()).data.some(item => item.id === model)) throw new Error("Model unavailable to this key");
const payload = {"model":"gemini-3.1-flash-image","prompt":"A product photograph of a ceramic cup on a light table; soft daylight, no text.","n":1,"size":"1024x1024","response_format":"b64_json","resolution":"1K"};
const response = await fetch(base + "/images/generations", {
 method: "POST", headers, body: JSON.stringify(payload), signal: AbortSignal.timeout(180000)
});
if (!response.ok) throw new Error("Generation HTTP " + response.status);
const result = await response.json();
if (result.warnings || result.api429?.parameter_mismatches) console.warn("Inspect warnings", result.warnings, result.api429);
if (result.data?.length !== 1 || !result.data[0].b64_json) throw new Error("Missing image or partial result; inspect before retrying");
const bytes = Buffer.from(result.data[0].b64_json, "base64");
const hex = bytes.subarray(0, 8).toString("hex");
const extension = hex === "89504e470d0a1a0a" ? "png" : hex.startsWith("ffd8ff") ? "jpg" : bytes.toString("ascii", 0, 4) === "RIFF" && bytes.toString("ascii", 8, 12) === "WEBP" ? "webp" : undefined;
if (!extension) throw new Error("Unknown image MIME; inspect before saving");
await writeFile("image." + extension, bytes);
console.log(result.api429?.outputs);

The examples are checked offline against the client contract and public schema. No paid execution or result quality is claimed. A verified complete image jobs contract is not available here: asynchronous fields and polling are omitted.

n8n: HTTP Request and saving the result

1. Check access to the exact ID using GET /v1/models.
2. Create an HTTP Request with POST to https://gateway.api429.com/v1/images/generations; store the Bearer key in credentials.
3. Send the JSON from curl with one result. Do not include the key in a workflow export.
4. Parse JSON, check the data count and warnings; decode b64_json and check MIME before saving.

HTTP Request documentation. Compatibility with specialized AI nodes and native SDKs needs separate verification.

Three options for your own comparison

Compare identical tasks and acceptance criteria. These are image models, not a quality ranking; conditional rows apply to their own configurations and do not form an equivalent benchmark.

Version and release date

Manufacturer release date, Google: Feb 26, 2026. The exact predecessor has not been established in the reviewed sources. This does not automatically replace the ID. The model’s addition date in API429 is unknown.

Frequently asked questions

Sources and review

• ai.google.dev/gemini-api/docs/models/gemini-3.1-flash-image
• ai.google.dev/gemini-api/docs/pricing
• ai.google.dev/gemini-api/docs/changelog
• gateway.api429.com/api/public/catalog
• gateway.api429.com/api/public/openapi.json
• client.api429.com/documentation

Editorial review: Oct 24, 2026. Pricing · Getting started · Compare the family: Nano Banana