Nano Banana API — это обычный Gemini API от Google, в котором вы указываете model id одной из моделей изображений. Чтобы начать, нужны три вещи: API-ключ из Google AI Studio, проект с подключённым платным уровнем (бесплатного уровня для моделей изображений нет) и запрос к методу generateContent с нужной моделью. Актуальная основная модель — Nano Banana 2.1, её id gemini-nano-banana-2.1, картинка 1K стоит $0.0336.
Ниже — таблица всех model id и цен, порядок получения ключа, минимальные примеры на curl и Python по формату документации Gemini API, а также ответы на частые вопросы: как встроить генерацию в сайт, как связать Nano Banana с другими нейросетями и можно ли подключить её к OBS.
Какие модели Nano Banana есть в API
Google ведёт несколько поколений параллельно, и при выборе id важно смотреть на статус.
| Модель | model id | Статус на ноябрь 2026 |
|---|---|---|
| Nano Banana 2.1 | gemini-nano-banana-2.1 |
актуальная основная модель, вышла 06.10.2026 |
| Nano Banana Pro | gemini-3-pro-image |
актуальна, для сложных профессиональных задач |
| Nano Banana 2 Lite | gemini-3.1-flash-lite-image |
актуальна, самая быстрая и дешёвая |
| Nano Banana 2 | gemini-3.1-flash-image |
deprecated с 06.10.2026, дата отключения не объявлена, замена — 2.1 |
| Nano Banana | gemini-2.5-flash-image |
legacy, отключение 15.03.2027, замена — 2 Lite |
Превью-идентификаторы gemini-3-pro-image-preview и gemini-3.1-flash-image-preview отключены 25.06.2026. Если старый код перестал работать, первым делом проверьте id. «Nano Banana 2 Pro» в API нет — такой модели Google не выпускал; по запросу «api nano banana pro» имеется в виду gemini-3-pro-image.
Полный список и даты отключения Google публикует на странице моделей изображений и странице deprecations.
Сколько стоит Nano Banana API
Оплата идёт за каждое выходное изображение, цена зависит от модели и разрешения. Цены платного уровня по странице тарифов Gemini API:
| Модель | 0.5K | 1K | 2K | 4K | Batch |
|---|---|---|---|---|---|
| Nano Banana 2.1 | — | $0.0336 | $0.0504 | $0.113 | вдвое дешевле |
| Nano Banana 2 | $0.045 | $0.067 | $0.101 | $0.151 | — |
| Nano Banana 2 Lite | — | $0.0336 | — | — | $0.0168 |
| Nano Banana Pro | — | $0.134 | $0.134 | $0.24 | — |
| Nano Banana (2.5 Flash Image) | — | $0.039 | — | — | $0.0195 |
Что из этого следует на практике:
- Nano Banana 2.1 выгоднее Nano Banana 2 при лучшем качестве — переход с 2 на 2.1 снижает расходы.
- Pro стоит в 4 раза дороже 2.1 за картинку 1K. Её стоит брать для инфографики, сложных композиций и задач с большим числом референсов.
- Batch подходит для массовых задач, где результат не нужен мгновенно, — например, генерация сотен карточек товаров за ночь.
- Grounding через Google Search: 5 000 бесплатных запросов в месяц на все модели Gemini 3+, дальше $14 за 1 000 запросов.
Для ориентира: 1 000 картинок 1K на Nano Banana 2.1 обойдутся в $33.6, на Pro — в $134. О подписках для обычных пользователей — в статье сколько стоит Nano Banana.
Как получить API-ключ
- Войдите в Google AI Studio. Откройте aistudio.google.com своим аккаунтом Google. Там же можно попробовать модели вручную — об этом в гиде по AI Studio.
- Создайте ключ. В разделе API-ключей создайте новый ключ и привяжите его к проекту Google Cloud.
- Подключите платный уровень. Для моделей изображений бесплатного уровня нет, поэтому проекту нужен активный биллинг. Без него запросы к Nano Banana будут отклоняться.
- Сохраните ключ в переменную окружения. Например,
GEMINI_API_KEY. Не вставляйте ключ прямо в код и не публикуйте его в репозитории. - Проверьте запрос. Отправьте минимальный запрос из примеров ниже и убедитесь, что в ответе пришло изображение.
Пример запроса на curl
Генерация идёт через метод generateContent. Чтобы модель вернула картинку, в generationConfig указывается responseModalities с IMAGE. Изображение приходит в ответе в виде base64 в поле inlineData.
curl -s -X POST \
"https://generativelanguage.googleapis.com/v1beta/models/gemini-nano-banana-2.1:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [{
"parts": [
{"text": "Создай реалистичное фото: чашка кофе на подоконнике, за окном дождливый вечерний город, тёплый свет лампы"}
]
}],
"generationConfig": {
"responseModalities": ["IMAGE"]
}
}' > response.json
grep -o '"data": "[^"]*"' response.json | cut -d'"' -f4 | base64 --decode > image.png
Последняя строка достаёт base64 из ответа и сохраняет картинку в image.png. Если файл пустой, откройте response.json: там будет текст ошибки — чаще всего неверный ключ, отсутствие биллинга или неподдерживаемый регион.
Пример на Python
Минимальный пример через обычный HTTP-запрос, без SDK — он повторяет формат REST из документации и не зависит от версии библиотек. Для правки фото в parts добавляется исходное изображение.
import base64
import os
import requests
API_KEY = os.environ["GEMINI_API_KEY"]
MODEL = "gemini-nano-banana-2.1"
URL = f"https://generativelanguage.googleapis.com/v1beta/models/{MODEL}:generateContent"
with open("photo.jpg", "rb") as f:
photo_b64 = base64.b64encode(f.read()).decode()
body = {
"contents": [{
"parts": [
{"text": "Замени фон на светлую студию с мягким светом. Лицо, позу и одежду оставь без изменений."},
{"inlineData": {"mimeType": "image/jpeg", "data": photo_b64}},
]
}],
"generationConfig": {"responseModalities": ["IMAGE"]},
}
resp = requests.post(URL, headers={"x-goog-api-key": API_KEY}, json=body, timeout=180)
resp.raise_for_status()
for part in resp.json()["candidates"][0]["content"]["parts"]:
if "inlineData" in part:
with open("result.png", "wb") as out:
out.write(base64.b64decode(part["inlineData"]["data"]))
print("Сохранено: result.png")
У Google есть и официальный SDK для Python — пакет google-genai, — но его методы меняются от версии к версии, поэтому сверяйте примеры с актуальной документацией Gemini API. Соотношение сторон и разрешение (1K, 2K, 4K) задаются в настройках изображения в generationConfig; допустимые значения зависят от модели и перечислены на странице моделей изображений. Простой вариант — указать формат прямо в тексте промпта: «вертикальный постер 9:16».
Промпты через API пишутся так же, как в приложении: связным текстом, с сильным глаголом в начале и явным указанием, что сохранить. Формулы и примеры — в инструкции по промптам.
Как встроить Nano Banana на сайт
Встраивать можно, но только через свой сервер. Правильная схема:
- Пользователь на сайте вводит промпт или загружает фото.
- Фронтенд отправляет данные на ваш бэкенд, а не напрямую в Google.
- Бэкенд добавляет API-ключ, вызывает Gemini API и возвращает картинку.
- Вы ограничиваете число запросов на пользователя, иначе один посетитель может потратить весь бюджет.
Что важно учесть:
- Ключ никогда не должен попадать в браузер. Любой JavaScript на странице читается посетителями.
- Модерация. Фильтры Google работают и в API, но отказы нужно корректно показывать пользователю, а не выдавать пустую картинку.
- Маркировка. На всех изображениях есть невидимый водяной знак SynthID — честнее подписывать результаты как сгенерированные ИИ.
- Персональные данные. Если пользователи загружают фото, предупредите, куда они передаются, и не храните их дольше необходимого.
Для мобильных и веб-приложений на Firebase у Google есть Firebase AI Logic — модели Nano Banana доступны и там. Для корпоративных задач — Vertex AI, который теперь называется Gemini Enterprise Agent Platform.
Nano Banana вместе с другими нейросетями
Связки с другими ИИ — частый сценарий, и API для этого подходит лучше всего:
- Текстовая модель пишет промпт, Nano Banana рисует. Например, Gemini или другая языковая модель превращает описание товара в подробный промпт для карточки, а Nano Banana 2.1 генерирует изображение.
- Nano Banana делает кадр, видеомодель его оживляет. Сама Nano Banana видео не создаёт, но её картинка может стать стартовым кадром для Gemini Omni или Veo во Flow.
- Пайплайны в ComfyUI. Модели Nano Banana доступны через партнёрские узлы ComfyUI — генерация при этом всё равно идёт в облаке.
- Партнёрские платформы. По данным самих сервисов, модели Nano Banana подключены к fal.ai, OpenRouter и Runway Dev — удобно, если у вас уже есть аккаунт и биллинг там.
Nano Banana и OBS
Прямой интеграции Nano Banana с OBS Studio нет: OBS ничего не генерирует сам. Рабочий вариант для стримеров — генерировать обложки, заставки и фоны заранее (в Gemini, AI Studio или скриптом через API) и добавлять их в сцену как источник «Изображение» или «Слайд-шоу изображений». Генерацию «в прямом эфире по команде зрителей» делают через собственного бота, который вызывает API, — схема такая же, как в руководстве по Telegram-боту на Nano Banana.
Доступ из России
Россия не входит в список поддерживаемых регионов Gemini API и Google AI Studio. Это касается и проекта, и платёжного профиля: работать с API законно можно, если ваша компания или сервер находятся в поддерживаемой стране и биллинг оформлен там же. Для личного использования из РФ проще и честнее взять русскоязычный агрегатор с оплатой в рублях — по данным сервисов, в их списках моделей есть Nano Banana 2.1, 2, 2 Lite и Pro.


