Nano Banana API: как получить ключ и использовать модель в своём проекте

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

Nano Banana API: как получить ключ и использовать модель в своём проекте

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-ключ

  1. Войдите в Google AI Studio. Откройте aistudio.google.com своим аккаунтом Google. Там же можно попробовать модели вручную — об этом в гиде по AI Studio.
  2. Создайте ключ. В разделе API-ключей создайте новый ключ и привяжите его к проекту Google Cloud.
  3. Подключите платный уровень. Для моделей изображений бесплатного уровня нет, поэтому проекту нужен активный биллинг. Без него запросы к Nano Banana будут отклоняться.
  4. Сохраните ключ в переменную окружения. Например, GEMINI_API_KEY. Не вставляйте ключ прямо в код и не публикуйте его в репозитории.
  5. Проверьте запрос. Отправьте минимальный запрос из примеров ниже и убедитесь, что в ответе пришло изображение.

Пример запроса на 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 на сайт

Встраивать можно, но только через свой сервер. Правильная схема:

  1. Пользователь на сайте вводит промпт или загружает фото.
  2. Фронтенд отправляет данные на ваш бэкенд, а не напрямую в Google.
  3. Бэкенд добавляет API-ключ, вызывает Gemini API и возвращает картинку.
  4. Вы ограничиваете число запросов на пользователя, иначе один посетитель может потратить весь бюджет.

Что важно учесть:

  • Ключ никогда не должен попадать в браузер. Любой 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.

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

Где взять API-ключ Nano Banana?
Ключ создаётся в Google AI Studio на aistudio.google.com в разделе API-ключей. Это ключ Gemini API: отдельного ключа именно для Nano Banana не бывает, модель выбирается в запросе по model id.
Есть ли бесплатный API Nano Banana?
Нет. Для моделей изображений бесплатного уровня Gemini API нет, в колонке Free Tier указано «Not available». Нужен платный уровень с привязанным биллингом.
Какой model id у Nano Banana Pro и Nano Banana 2?
Nano Banana Pro — gemini-3-pro-image, Nano Banana 2 — gemini-3.1-flash-image, Nano Banana 2.1 — gemini-nano-banana-2.1. Превью-версии с суффиксом -preview отключены 25.06.2026.
Сколько стоит одна картинка через API?
У Nano Banana 2.1 — $0.0336 за 1K, $0.0504 за 2K и $0.113 за 4K. У Nano Banana Pro — $0.134 за 1K и 2K и $0.24 за 4K. Batch-режим у 2.1 вдвое дешевле.
Можно ли вызывать Nano Banana API из России?
Россия не входит в список поддерживаемых регионов Gemini API. Проект и сервер должны находиться в поддерживаемой стране; из РФ законно пользоваться моделью через русскоязычные агрегаторы.

Читайте дальше