Nano Banana 2 API: настройки, стоимость и подключение

Точный ID: gemini-3.1-flash-image. Доступ вашего ключа проверяется через GET /v1/models; опубликованная модель не гарантирует доступ любого аккаунта.

Цены и единицы оплаты

Каталог API429 сформирован 2026-10-24T01:22:46.807388Z. Таблица показывает компоненты прямого запроса; другие метрики общего каталога здесь не прибавляются. Для чтения цены округлены до шести знаков; расчёт использует точные ставки каталога. Калькулятор ниже использует контракт прямого Images запроса. Сверка источников: 2026-10-24.

Google Standard: $0.50 за 1M входных токенов, $3 за 1M текстового/thinking выхода, $60 за 1M image tokens. Калькулятор сравнивает выходной компонент; полный нативный запрос может включать дополнительные части. Источники тарифов — в разделе ниже. Batch, кеш и специальные режимы не смешиваются с базовым сравнением.

Бюджет генерации изображений

Характеристики и границы совместимости

• Нативные пределы Google: вход 131 072 токена, выход 32 768 токенов; это отдельные пределы, не общее окно и не подтверждённые лимиты API429.
• Google описывает выход 0.5K/1K/2K/4K и текст с изображением; клиентский контракт API429 перечисляет resolution 1K/2K/4K. Нативные grounding, thinking и Batch не обещаются через этот метод.
• Nano Banana 2 — точный gemini-3.1-flash-image. Nano Banana Pro, Lite и 2.1 — другие модели; их свойства нельзя переносить по семейному названию.

Спецификация Google, сверка 2026-10-24. Это не подтверждённые эффективные лимиты API429. Нативные параметры и возможности производителя проверяйте отдельно по клиентскому методу.

Опубликованные возможности точного ID: chat image_editing image_generation vision . Отсутствие поля не является доказательством запрета, но не позволяет обещать совместимость.

Публичные наблюдения по модели

За последние 24 часа: среднее время успешного ответа — 64 с; доля ошибок сервиса — 4,6%. Данные на 2026-10-24T01:23:18.390495Z.

Источник: публичная статистика за 24 часа. Среднее не является медианой или гарантией времени ответа; это не оценка качества изображения.

Первый запрос: curl, Python, JavaScript

Задайте API429_API_KEY на сервере и проверьте точный ID через GET https://gateway.api429.com/v1/models с тем же Bearer-ключом. Генерация платная; автоматические повторы не выполняются. Неопределённый таймаут не доказывает отсутствие списания.

Примеры запрашивают один результат и b64_json. curl сохраняет JSON в image-response.json; Python и JavaScript декодируют файл после проверки MIME по сигнатуре. При выборе url сначала различите hosted URL и data URI. Проверьте предупреждения, частичный результат, api429.outputs и api429.parameter_mismatches, если они присутствуют.

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":"Предметная фотография керамической чашки на светлом столе; мягкий дневной свет, без надписей.","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\":\"Предметная фотография керамической чашки на светлом столе; мягкий дневной свет, без надписей.\",\"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":"Предметная фотография керамической чашки на светлом столе; мягкий дневной свет, без надписей.","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);

Примеры проверяются offline по клиентскому контракту и публичной схеме. Платный запуск и качество результата не заявляются. Подтверждённый полный image jobs контракт здесь отсутствует: асинхронные поля и polling не приводятся.

n8n: HTTP Request и сохранение результата

1. Проверьте доступ точного ID через GET /v1/models.
2. Создайте HTTP Request с POST на https://gateway.api429.com/v1/images/generations; храните Bearer-ключ в credentials.
3. Передайте JSON из curl с одним результатом. Не включайте ключ в экспорт workflow.
4. Разберите JSON, проверьте количество data и предупреждения; декодируйте b64_json и проверьте MIME перед сохранением.

Документация HTTP Request. Совместимость специальных AI-узлов и нативных SDK требует отдельной проверки.

Три варианта для собственного сравнения

Сравнивайте одинаковые задания и критерии приёмки. Это модели изображений, не рейтинг качества; условные строки относятся к своим конфигурациям и не составляют равнозначный benchmark.

Версия и дата выпуска

Дата выпуска у Google: 2026-02-26. Точный предшественник в проверенных источниках не установлен. Это не автоматическая замена ID. Дата появления модели в API429 не установлена.

Частые вопросы

Источники и проверка

• 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

Редакционная проверка: 2026-10-24. Тарифы · Начало работы · Сравнение семейства Nano Banana