Nano Banana API: документация, ключ и пошаговая инструкция

Официальный Nano Banana API — это не отдельный сервис, а модели генерации изображений внутри Gemini API от Google. Документация находится на ai.google.dev в разделе Image generation, ключ выдаёт Google AI Studio, а для нового кода Google рекомендует gemini-nano-banana-2.1 (Nano Banana 2.1). Все примеры на странице Image generation написаны на Interactions API — более новом интерфейсе Gemini API. Прежний метод generateContent продолжает работать, но для нового кода Google рекомендует Interactions.

Две вещи лучше знать заранее. Бесплатного уровня для генерации изображений через API нет: каждая картинка оплачивается, у Nano Banana 2.1 в разрешении 1K это $0,0336 плюс токены рассуждения. А Россия не входит в список регионов, где доступны Google AI Studio и Gemini API, — подробности в отдельном разделе ниже.

Модели, цены и даты в статье приведены по состоянию на 8 октября 2026 года.

Что изменилось с 29 сентября 2026 года: Nano Banana 2.1 и новые сроки

• 6 октября 2026 года вышла Nano Banana 2.1 (gemini-nano-banana-2.1, статус Stable). Google называет её обновлением Nano Banana 2 и рекомендует для всех новых проектов, поэтому во всех примерах ниже стоит этот ID.
• Nano Banana 2 (gemini-3.1-flash-image) в Gemini API объявлена устаревшей. Даты отключения нет, модель пока отвечает, но Google просит переходить на 2.1. Размер 512px остался только у неё.
• Цены 2.1 ниже, чем у Nano Banana 2: $0,0336 за 1K, $0,0504 за 2K и $0,113 за 4K против $0,067, $0,101 и $0,151.
• У gemini-2.5-flash-image теперь две даты. Таблица отключений Gemini API указывает 15 марта 2027 года, а страница цен по-прежнему пишет о 2 октября 2026 года.

Подробно о самой модели — в статье «Nano Banana 2.1: цена от $0,0336, вдвое ниже NB2 в 1K и 2K».

Где официальная документация и чем она отличается от сайтов «Nano Banana API»

В терминах Google «Nano Banana» — название встроенной в Gemini генерации изображений, а не одной модели. Под этим именем в Gemini API сейчас работают пять моделей: Nano Banana 2.1, Nano Banana 2 Lite, Nano Banana 2, Nano Banana Pro и старая Nano Banana. Все сгенерированные ими изображения содержат водяной знак SynthID.

Сайты, у которых «Nano Banana API» стоит в домене или в заголовке раздела «Документация API», к Google не относятся, даже если называют себя официальными. У них собственный адрес запросов, собственный токен и собственные тарифы: одни перепродают доступ к моделям Google, у других публичный API ещё в разработке. Их документация не описывает Gemini API, а ключ из AI Studio к ним отношения не имеет.

Ещё одна частая путаница — материалы 2025 года. Тогда «Nano Banana» означало одну модель, Gemini 2.5 Flash Image, и в примерах встречается gemini-2.5-flash-image-preview. Этот идентификатор отключён 15 января 2026 года, а Google в качестве замены указывает gemini-nano-banana-2.1.

Официальная документация разбита на несколько страниц. Вот какая из них отвечает на какой вопрос:

Доступен ли Nano Banana API из России

Официально нет. По состоянию на 8 октября 2026 года Россия отсутствует в списке регионов Gemini API и Google AI Studio (страница обновлена 28 апреля 2026 года). Google Cloud, к проектам которого привязан каждый ключ Gemini API, приостановил новые регистрации в России ещё в 2022 году. На практике это значит, что официально получить ключ и подключить оплату из России нельзя. Инструкция ниже рассчитана на аккаунт и проект Google в поддерживаемом регионе.

Если нужен доступ без аккаунта Google, остаются сторонние шлюзы, которые принимают запросы к моделям Nano Banana через свой API. Например, laozhang.ai по своей документации о Nano Banana 2.1 берёт $0,045 за вызов gemini-nano-banana-2.1 независимо от размера; разбор этого варианта — в статье «Nano Banana API: сравнение Google и laozhang.ai по цене и надежности». Шлюз — не маршрут Google: форму запроса, набор поддерживаемых функций, лимиты и цены определяет посредник, поэтому сказанное ниже про Interactions API к нему автоматически не относится. Что Google даёт бесплатно в пользовательских продуктах, собрано в материале «Nano Banana бесплатно: что даёт Google и что доступно из России».

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Какую модель выбрать: Nano Banana 2.1 по умолчанию

Начинайте с gemini-nano-banana-2.1: Google называет её основной рабочей моделью для генерации и редактирования изображений, а Nano Banana 2 — предыдущим поколением, вместо которого во всех новых проектах рекомендует 2.1. Переходить на другую модель стоит, только когда появилась конкретная причина.

Цены — эквивалент Google за одно изображение на платном уровне в долларах США. У Nano Banana 2.1 изображение 2K стоит $0,0504, 4K — $0,113; в Batch — $0,0168, $0,0252 и $0,0567. У Pro 1K и 2K стоят одинаково, 4K — $0,24; у Nano Banana 2 изображение 512px стоит $0,045. Сверху оплачиваются входные токены и токены рассуждения: у 2.1 это $1,50 за 1 млн входных токенов и $7,50 за 1 млн токенов текста и рассуждения. Полная модель расходов — в статье «Цены Nano Banana API: Lite, Nano Banana 2, Pro и Batch».

Правило выбора на практике:

• Lite за изображение 1K стоит столько же, сколько 2.1, поэтому брать её стоит ради скорости и более дешёвых входных токенов ($0,25 против $1,50 за 1 млн). Серии правок и несколько исходных изображений — не её сценарий, а поиск Google она не поддерживает.
• Pro оправдана, когда текст на картинке должен совпасть дословно: инфографика с большим количеством надписей, макет, фирменный стиль, локализация. В сравнении на одних и тех же 9 промптах (1K, по одной генерации на промпт) Pro сохранила заданные формулировки, а 2.1 изменила текст в трёх текстовых задачах — см. «Nano Banana 2.1 vs Pro vs GPT Image 2.5: сравнение на 9 задачах». Если ответ должен чередовать текст и несколько изображений, тоже берите Pro. Её особенности (JSON, YAML, PDF на входе) описаны в статье «Nano Banana Pro API: официальный JSON, YAML, PDF и разбор ошибок».
• Nano Banana 2.1 закрывает всё остальное, включая 4K, серию правок, до 14 референсов и опору на поиск по картинкам.
• Nano Banana 2 оставляйте, только если нужен размер 512px; сравнение трёх моделей — в статье «Nano Banana 2 vs Pro vs 2.1: что выбрать, если NB2 устарела».

Код для всех моделей одинаковый: чтобы сравнить результат, достаточно заменить значение model — в пределах того, что поддерживает выбранная модель (например, Lite не примет 2K, а 2.1 не примет 512px).

Схема ниже составлена 29 сентября 2026 года, до выхода 2.1: на ней четыре прежние модели, и Nano Banana 2 там ещё отмечена как выбор по умолчанию.

Шаг 1. Ключ, оплата и SDK

Ключ создаётся в Google AI Studio на странице API Keys. Новому пользователю AI Studio сама создаёт проект Google Cloud и ключ сразу после принятия условий использования. Если у вас уже есть аккаунт Google Cloud, проект по умолчанию не появится: существующий проект нужно импортировать кнопкой Import projects, и после этого создать для него ключ.

Что важно про ключи сейчас:

• Каждый ключ принадлежит проекту Google Cloud. Оплата и лимиты считаются на проект, а не на ключ, поэтому второй ключ в том же проекте квоту не увеличит.
• С 28 мая 2026 года новые ключи в AI Studio создаются как ключи авторизации (auth keys). Они привязаны к сервисному аккаунту и по умолчанию ограничены Gemini API.
• Запросы с неограниченных стандартных ключей Gemini API отклоняет. Если у вас старый ключ с пометкой Unrestricted, в AI Studio выберите Add restrictions → Restrict to Gemini API only. Стандартные ключи с явными ограничениями продолжают работать.

Так как бесплатного уровня для вывода изображений нет, к проекту нужно привязать платёжный аккаунт. Привязка оплаты переводит проект на первый платный уровень (Tier 1).

Ключ храните в переменной окружения, а не в коде. SDK Google сами читают GEMINI_API_KEY или GOOGLE_API_KEY; если заданы обе, приоритет у GOOGLE_API_KEY.

export GEMINI_API_KEY="ваш_ключ"

# Python
pip install -U "google-genai>=2.3.0"

# JavaScript / TypeScript
npm install "@google/genai@^2.3.0"

Interactions API поддерживается в google-genai для Python и @google/genai для JavaScript начиная с версии 2.3.0. Примеры с пакетом google-generativeai и import google.generativeai относятся к другому, прежнему SDK — их лучше не смешивать с кодом ниже.

Шаг 2. Первый запрос к Nano Banana 2.1: Python, JavaScript и REST

Все примеры кода в этой инструкции построены по документации Google и с ключом Google не запускались. Единственный живой прогон — восемь вызовов gemini-nano-banana-2.1 через шлюз laozhang.ai 8 октября 2026 года, семь из них в формате generateContent; что они показали, сказано в разделах о размере и о режиме рассуждения.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

По умолчанию модель отвечает текстом и изображением. SDK даёт короткий доступ к последней картинке через output_image, а к тексту — через output_text. Если изображения в ответе нет, подсказку — например, отказ модели — стоит искать в текстовой части, поэтому её полезно выводить.

Python:

import base64
from google import genai

client = genai.Client()  # ключ берётся из GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Кофейная кружка в форме банана на деревянном столе, мягкий утренний свет",
)

image = interaction.output_image
if image is None:
    print(interaction.output_text)
else:
    with open("banana.png", "wb") as f:
        f.write(base64.b64decode(image.data))

JavaScript (файл с расширением .mjs или проект с "type": "module"):

import { GoogleGenAI } from "@google/genai";
import * as fs from "node:fs";

const ai = new GoogleGenAI({}); // ключ берётся из GEMINI_API_KEY

const interaction = await ai.interactions.create({
  model: "gemini-nano-banana-2.1",
  input: "Кофейная кружка в форме банана на деревянном столе, мягкий утренний свет",
});

const image = interaction.output_image;
if (image) {
  fs.writeFileSync("banana.png", Buffer.from(image.data, "base64"));
} else {
  console.log(interaction.output_text);
}

REST. Ответ приходит в JSON: изображение лежит в массиве steps, в шаге типа model_output, в блоке image в виде base64. Для извлечения ниже используется jq:

curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": [
      {"type": "text", "text": "Кофейная кружка в форме банана на деревянном столе, мягкий утренний свет"}
    ]
  }' > response.json

jq -r '[.steps[] | select(.type == "model_output") | .content[] | select(.type == "image") | .data] | last' response.json \
  | base64 --decode > banana.png

Python- и JavaScript-примеры повторяют официальные образцы со страницы Image generation, где Google показывает их уже с gemini-nano-banana-2.1; извлечение через jq построено по описанной в документации схеме steps. Если запрос вернул код 200, но картинки нет, разбор причин — в статье «Nano Banana не генерирует изображение в API: как найти причину».

Шаг 3. Редактирование, серия правок и несколько референсов

Правка по исходному изображению

Чтобы изменить готовую картинку, передайте в input список блоков: текст с задачей и изображение в base64 с указанием MIME-типа.

import base64
from google import genai

client = genai.Client()

with open("product.png", "rb") as f:
    source = base64.b64encode(f.read()).decode("utf-8")

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=[
        {"type": "text", "text": "Замени фон на светло-серую студийную подложку, сам товар не меняй"},
        {"type": "image", "data": source, "mime_type": "image/png"},
    ],
)

with open("product_edited.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))

Крупные файлы удобнее загружать через Files API — этот способ описан на странице Image understanding в документации Google. Учтите, что входные изображения у 2.1 тарифицируются как входные токены по $1,50 за 1 млн — втрое дороже, чем у Nano Banana 2.

Серия правок без повторной отправки картинки

Interactions API хранит историю на сервере. Чтобы продолжить с того же изображения, передайте previous_interaction_id — идентификатор предыдущего ответа. Картинку заново отправлять не нужно:

second = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Сделай подложку тёплой бежевой, остальное оставь как есть",
    previous_interaction_id=interaction.id,
    response_format={"type": "image", "aspect_ratio": "4:5", "image_size": "2K"},
)

with open("product_beige.png", "wb") as f:
    f.write(base64.b64decode(second.output_image.data))

То же через REST — идентификатор берётся из поля id первого ответа:

PREVIOUS_INTERACTION_ID=$(jq -r '.id' response.json)

curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\": \"gemini-nano-banana-2.1\",
    \"input\": \"Сделай подложку тёплой бежевой, остальное оставь как есть\",
    \"previous_interaction_id\": \"$PREVIOUS_INTERACTION_ID\",
    \"response_format\": {\"type\": \"image\", \"aspect_ratio\": \"4:5\", \"image_size\": \"2K\"}
  }" > response2.json

На платном уровне сервер хранит взаимодействия 55 дней, на бесплатном — 1 день. Параметр store=false отключает хранение, но тогда на этот ответ уже нельзя сослаться через previous_interaction_id, и он несовместим с фоновым режимом. Устойчивость персонажа в многоходовой работе Google называет одним из главных улучшений 2.1. Для серий правок Lite не подходит: Google прямо пишет, что она не оптимизирована под последовательное редактирование.

Несколько референсов

Несколько исходных изображений передаются так же — дополнительными блоками image в одном input. Лимиты зависят от модели (см. таблицу выбора модели): у Nano Banana 2.1 и Nano Banana 2 до 10 объектов и 4 персонажей, у Pro до 6 объектов, 5 персонажей и 3 образцов стиля, у старой gemini-2.5-flash-image лучший результат — до 3 изображений.

def image_block(path):
    with open(path, "rb") as f:
        data = base64.b64encode(f.read()).decode("utf-8")
    return {"type": "image", "data": data, "mime_type": "image/png"}

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=[{"type": "text", "text": "Групповое фото этих людей в офисе, все корчат смешные рожицы"}]
    + [image_block(p) for p in ["anna.png", "boris.png", "vera.png"]],
    response_format={"type": "image", "aspect_ratio": "5:4", "image_size": "2K"},
)

Размер 1K–4K, соотношение сторон и формат ответа

Все настройки вывода задаются в response_format с "type": "image":

• aspect_ratio — соотношение сторон, например "16:9" или "4:5". Без него модель повторяет пропорции входного изображения, а если его нет — рисует квадрат 1:1. Nano Banana 2.1 поддерживает 14 соотношений, включая вытянутые 1:4, 4:1, 1:8 и 8:1; по данным Google, в 2.1 исправлены артефакты-повторы на таких форматах в 2K и 4K. Полный список по каждой модели — в таблицах на странице Image generation.
• image_size — "1K" (по умолчанию), "2K" или "4K". Буква K — только заглавная: "2k" API отклонит. Lite умеет только 1K. Размер 512px есть только у Nano Banana 2, у 2.1 его нет; точное значение параметра для 512px сверьте с разделом о разрешении на странице Image generation.
• mime_type — формат файла, например "image/jpeg".

В вызовах gemini-nano-banana-2.1 через laozhang.ai 8 октября 2026 года (по одному запросу на настройку) 2K в 16:9 вернул кадр 2752×1536, 4K — 5504×3072 (файл 8,6 МБ), без явного mime_type все ответы пришли в JPEG. Запрос с размером "512" ошибку не вернул: пришла картинка 1024×1024, и вызов был оплачен как обычный, хотя днём ранее тот же запрос получал HTTP 400. Поэтому 512 для 2.1 не отправляйте вовсе.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Указанный формат изображения заодно отключает текст: модель вернёт только картинку. Если нужны и текст, и изображение, передайте массив:

curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": "Короткое стихотворение о звёздной ночи и иллюстрация к нему",
    "response_format": [
      {"type": "text"},
      {"type": "image"}
    ]
  }'

Размер влияет на цену: у Nano Banana 2.1 изображение 2K стоит в 1,5 раза дороже, чем 1K ($0,0504 против $0,0336), а 4K — примерно в 3,4 раза ($0,113). Для черновиков и подбора промпта разумно оставлять 1K, а 2K или 4K включать для финальной версии.

Опора на Google Поиск, режим рассуждения, видео и Batch

Grounding (опора на результаты Google Поиска). Если картинка зависит от свежих данных — прогноз погоды, биржевой график, недавнее событие, — добавьте инструмент поиска:

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input="Прогноз погоды в Москве на 5 дней в виде аккуратной инфографики",
    tools=[{"type": "google_search"}],
    response_format={"type": "image", "aspect_ratio": "16:9"},
)

Ответ тогда содержит шаги google_search_call и google_search_result, а в тексте появляются ссылки на источники (url_citation). Nano Banana 2.1 и Nano Banana 2 умеют искать ещё и по картинкам: tools=[{"type": "google_search", "search_types": ["web_search", "image_search"]}]. В этом случае Google требует показывать пользователю подсказки поиска из поля search_suggestions. Реальные фотографии людей из веб-поиска эти модели пока не используют. Lite поиск не поддерживает. Первые 5 000 поисковых запросов в месяц на все модели Gemini 3.x бесплатны, дальше — $14 за 1 000.

Режим рассуждения (thinking). Nano Banana 2.1, Nano Banana 2, Lite и Pro перед генерацией обдумывают композицию, и выключить это нельзя. В процессе они могут создать до двух промежуточных «черновых» изображений — за них не платят, но токены рассуждения оплачиваются. Глубину задаёт generation_config={"thinking_level": "high"}. У Nano Banana 2.1 три уровня — minimal, medium (по умолчанию) и high; у Nano Banana 2 и Lite только minimal (по умолчанию) и high.

В тех же вызовах через laozhang.ai токены рассуждения приходили на каждом запросе, в том числе с minimal: от 510 до 1 107. По тарифу Google $7,50 за 1 млн это примерно $0,004–0,008 сверху к цене кадра. Уровень high в паре с minimal добавил около 10 секунд (34,8 против 24,7 с), но заметно больше токенов не дал; это по одному запросу на уровень, а не замер.

Примечание: laozhang.ai — наш собственный сервис; его цены — наши тарифы, а не независимое сравнение.

Чередование текста и изображений. Если модель отвечает несколькими картинками вперемешку с текстом (типичный сценарий для Pro), output_image вернёт только последнюю. Все блоки нужно обойти в steps:

count = 0
for step in interaction.steps:
    if step.type == "model_output":
        for block in step.content:
            if block.type == "text":
                print(block.text)
            elif block.type == "image":
                count += 1
                with open(f"part_{count}.png", "wb") as f:
                    f.write(base64.b64decode(block.data))

Видео на входе. Публичную ссылку YouTube или файл через Files API можно передать Nano Banana 2.1, Nano Banana 2 и Lite — например, чтобы сделать постер или инфографику по ролику. Pro и старая модель видео не принимают, аудио на входе не поддерживается ни одной из моделей.

Batch. Все возможности генерации изображений доступны через Batch API: лимиты выше, цена вдвое ниже, но результат приходит в течение 24 часов. Это подходит для каталогов и фоновых задач, но не для интерактивного интерфейса. Flex и Priority для Nano Banana 2.1 карточка модели отмечает как неподдерживаемые, так что дешевле стандартной цены у 2.1 только Batch.

Старый код: что сломалось и как перенести

Если код взят из туториала 2025 года или начала 2026-го, сверьте его с этой хронологией:

Preview-ID отключены именно в Gemini API: код и узлы ComfyUI, которые до сих пор их отправляют, получат ошибку. Простое удаление суффикса -preview у gemini-3.1-flash-image-preview приведёт к устаревшей Nano Banana 2, а не к рекомендованной замене. В ComfyUI для 2.1 есть отдельный партнёрский узел «Nano Banana 2.1» (нужна ComfyUI 0.39.1 или новее); он работает через аккаунт Comfy и предоплаченные кредиты, а не через ключ Gemini API.

Переход с Nano Banana 2 на 2.1

Для большинства запросов достаточно заменить model. Расходятся модели в нескольких местах:

Если в запросах много референсов, выигрыш на выходном изображении частично съедают более дорогие входные токены; для генерации по тексту 2.1 дешевле в любом размере. Если задержка важна, явно передайте "thinking_level": "minimal", чтобы не получить уровень medium по умолчанию.

Если остаётесь на generateContent

Метод generateContent по-прежнему полностью поддерживается, поэтому рабочую интеграцию можно не переписывать срочно — достаточно обновить ID модели. Настройки изображения в нём задаются через generationConfig.imageConfig, а не через response_format. Пример ниже составлен по полям справочника generateContent:

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-nano-banana-2.1",
    contents="Кофейная кружка в форме банана на деревянном столе, мягкий утренний свет",
    config=types.GenerateContentConfig(
        response_modalities=["IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="16:9", image_size="2K"),
    ),
)

for part in response.candidates[0].content.parts:
    if part.inline_data:
        with open("banana.png", "wb") as f:
            f.write(part.inline_data.data)

При переносе на Interactions поля соотносятся так:

В справочнике generateContent перечислены соотношения 1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 и 21:9 и размеры 512, 1K, 2K и 4K. Какие из них принимает конкретная модель, по-прежнему определяет таблица на странице Image generation: у 2.1, например, нет 512.

Тем, кто работает через Google Cloud с сервисными аккаунтами, подойдёт другой вход в те же модели. В Vertex AI сроки другие: gemini-3.1-flash-image там поддерживается до 28 мая 2027 года или дольше, а gemini-nano-banana-2.1 доступна в регионе global, и параметры seed, topK, temperature и topP для неё возвращают ошибку. Подробнее — в статье «Nano Banana API в Vertex AI: рабочие модели, настройка и цена» и в сравнении «Gemini API или Vertex AI API: какой маршрут Google Gemini выбрать».

Лимиты Gemini API для изображений и ошибка 429

Лимиты Gemini API считаются на проект и зависят от уровня оплаты. Для моделей Nano Banana действует ограничение на число изображений в минуту (IPM). Конкретные цифры для вашего проекта показывает AI Studio в разделе с активными лимитами — в документации их нет. На странице лимитов (обновлена 2 сентября 2026 года) отдельной строки для Nano Banana 2.1 пока нет, в том числе в таблице очереди Batch.

Кроме того, у каждого платного уровня есть лимит расходов за скользящие 10 минут: $10 на Tier 1, $50 на Tier 2 и $200 на Tier 3. Превышение возвращает ошибку 429 RESOURCE_EXHAUSTED. Tier 2 открывается после $100 оплаченных расходов и 3 дней с первого успешного платежа, Tier 3 — после $1 000 и 30 дней.

Какой именно лимит сработал при 429, разобрано в статье «Ошибка 429 Gemini при генерации изображений: какой лимит сработал», а квоты по уровням — в материале «Лимиты Nano Banana 2: сколько изображений в день в Gemini и API». Что делать при 503 или отказе модели, — в статье «Nano Banana API не работает: как разобрать 429, 503, отсутствие изображения и отказ». Если результат не устраивает по содержанию, начните с приёмов из руководства «Как писать промпты для Nano Banana».

Частые вопросы о Nano Banana API

Есть ли бесплатный Nano Banana API? Нет. На странице цен Gemini API у всех моделей изображений, включая Nano Banana 2.1, бесплатный уровень для вывода отмечен как недоступный. Сам ключ создаётся бесплатно, но каждая сгенерированная картинка оплачивается. Бесплатно рисует приложение Gemini: там без подписки работает Nano Banana 2, без опубликованного числа картинок в день. С планом Google AI, по продуктовой странице Gemini, рисует Nano Banana 2.1, хотя справка Google пока описывает только Nano Banana 2. Подробнее — в статье «Сколько картинок бесплатно в Gemini: лимиты по сервисам Google».

Какой model ID у Nano Banana 2.1, Nano Banana 2 и Nano Banana Pro? Nano Banana 2.1 — gemini-nano-banana-2.1, Nano Banana 2 — gemini-3.1-flash-image (устарела), Nano Banana Pro — gemini-3-pro-image, Lite — gemini-3.1-flash-lite-image. Варианты с суффиксом -preview отключены 25 июня 2026 года.

Нужно ли переписывать код с generateContent на Interactions API? Не срочно: generateContent полностью поддерживается. Срочно нужно другое — заменить отключённые preview-ID, уйти с gemini-2.5-flash-image, для которой Google называет две разные даты отключения, и запланировать переход с Nano Banana 2 на 2.1. Interactions стоит выбрать для нового кода, особенно если нужна серия правок через previous_interaction_id.

Можно ли пользоваться Nano Banana API из России? Официально нет: Россия не входит в список регионов Gemini API и AI Studio, а Google Cloud не принимает новые регистрации из России. Сторонние шлюзы дают доступ к тем же моделям через собственный API, но форму запроса, функции и цены там определяет посредник.

Можно ли писать промпты по-русски? Да. Русский (ru-RU) входит в список языков, на которых, по данным Google, генерация изображений работает лучше всего.

Добавляет ли Google водяной знак на изображения? Да. По документации Google, все изображения моделей Nano Banana содержат водяной знак SynthID.