Как получить Nano Banana Pro API Key: предоплата от $5 и квота

Ключ для Nano Banana Pro создаётся в Google AI Studio на странице API keys за минуту и бесплатно. Сгенерировать картинку с ним получится только после подключения оплаты: у всех моделей изображений в Gemini API нет бесплатного уровня, а новый платёжный аккаунт по умолчанию переходит на предоплату с минимальным пополнением $5. В запросах указывайте ID gemini-3-pro-image; по состоянию на 10 октября 2026 года картинка 1K или 2K стоит $0,134, 4K — $0,24. Если Pro нужен не ради точного текста на изображении, дешевле обойдётся Nano Banana 2.1 (gemini-nano-banana-2.1, от $0,0336 за 1K).

Для читателей из России: в списке регионов Gemini API и AI Studio (обновлён 28 апреля 2026 года) России нет, поэтому официально получить ключ и оплатить картинки Nano Banana Pro оттуда нельзя.

Бесплатен ли API key Nano Banana Pro: ключ — да, картинки — нет

Сам ключ бесплатен, создать его в AI Studio ничего не стоит. Бесплатных картинок он при этом не даёт: на странице цен Gemini API по состоянию на 10 октября 2026 года у всех моделей изображений — Nano Banana Pro, Nano Banana 2, 2.1 и 2 Lite — в колонке Free Tier стоит «Not available». Ключ только открывает доступ к проекту Google Cloud, а за запросы платит платёжный аккаунт, привязанный к этому проекту, поэтому второй ключ в том же проекте не добавляет ни квоты, ни бесплатных запросов. Чтобы получить первую картинку, нужно подключить оплату: новый аккаунт по умолчанию работает по предоплате с минимумом $5.

Во что обойдётся первая картинка. Минимальной предоплаты $5 при цене $0,134 за изображение 1K или 2K хватит примерно на 37 картинок Pro ($5 / $0,134 ≈ 37,3), в 4K — на 20 ($5 / $0,24 ≈ 20,8), через Batch в 1K — на 74 ($5 / $0,067 ≈ 74,6). На практике выйдет немного меньше: сверху оплачиваются входные токены и токены размышлений, расчёт приведён в разделе о цене ниже. Предоплаченные кредиты действуют 12 месяцев и не возвращаются.

Сервисы, которые обещают «бесплатный Nano Banana API» или продают готовые ключи, к бесплатному уровню Google отношения не имеют. Такой ключ принадлежит чужому проекту и чужому платёжному аккаунту, а условия, обработку данных и то, какая модель на самом деле отвечает, определяет сам сервис.

Что изменилось с февраля 2026 года

В феврале 2026 года Nano Banana Pro был доступен в API только как preview. С тех пор Google поменял почти всё, что влияет на первый запуск:

• ID модели. gemini-3-pro-image вышел в общий доступ (GA) 28 мая 2026 года, а gemini-3-pro-image-preview отключён 25 июня 2026 года (таблица устаревших моделей Gemini API). Код и узлы ComfyUI со старым ID больше не работают.
• Тип ключа. С 28 мая 2026 года все новые ключи из AI Studio создаются как auth keys, а стандартные ключи без ограничений Gemini API отклоняет.
• Оплата. Биллинг подключается прямо в AI Studio, новые аккаунты по умолчанию работают по предоплате (Prepay), минимум $5. При нулевом балансе запросы получают HTTP 402.
• Уровни. Tier 2 теперь открывается после $100 оплаты и 3 дней, а не после $250 и 30 дней.
• Способ вызова. Для нового кода Google рекомендует Interactions API; generateContent по-прежнему полностью поддерживается.
• Более дешёвая модель. 6 октября 2026 года вышла Nano Banana 2.1 — сейчас это основная модель в документации Google по генерации изображений.

gemini-3-pro-image или Nano Banana 2.1: какой ID ставить в код

Nano Banana Pro — это модель Gemini 3 Pro Image с кодом gemini-3-pro-image. По странице модели в документации Gemini API (на 8 октября 2026 года) она принимает текст и изображения, отдаёт изображения и текст, держит до 65 536 входных и до 32 768 выходных токенов, поддерживает режим размышлений (thinking), привязку к Google Поиску и Batch API. Структурированный вывод в JSON (structured outputs) у неё не поддерживается. Срок отключения gemini-3-pro-image в Gemini API не объявлен.

Pro стоит брать, когда на картинке важен точный текст, вёрстка или детали бренда. В сравнении на 9 одинаковых промптах (1K, одна генерация на промпт, 8 октября 2026 года) Pro сохранил заданные надписи, а Nano Banana 2.1 изменила формулировку в трёх задачах с текстом — подробности в материале Nano Banana 2.1 vs Pro vs GPT Image 2.5: сравнение на 9 задачах. По собственным оценкам Google, 2.1 опережает Pro по общему предпочтению и редактированию, а 1K у неё в четыре раза дешевле: $0,0336 против $0,134. Для фото, иллюстраций и потоковой генерации обычно хватает её. Что умеет новая модель, разобрано в статье Nano Banana 2.1: цена от $0,0336, вдвое ниже NB2 в 1K и 2K. Если вы выбираете между Pro и моделями других разработчиков, посмотрите также сравнение FLUX.2 Pro и Nano Banana Pro для изображений с текстом и референсами.

Ключ, оплата и квоты для обеих моделей общие: всё, что описано ниже, работает и для 2.1, меняется только ID модели в запросе.

Шаг 1. Создайте ключ в Google AI Studio

1. Войдите в Google AI Studio с аккаунтом Google. Новым пользователям AI Studio по умолчанию создаёт проект и ключ к нему.
2. Откройте страницу API keys. Если ключ уже есть, его можно использовать. Для нового ключа нажмите Create API key и выберите проект в диалоге.
3. Если нужного проекта нет в списке, импортируйте его: AI Studio по умолчанию показывает не все проекты Google Cloud, а только импортированные.
4. Скопируйте ключ в переменную окружения, а не в код:

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

Библиотеки Gemini API сами читают GEMINI_API_KEY или GOOGLE_API_KEY. Если заданы обе переменные, побеждает GOOGLE_API_KEY — частая причина ситуации, когда новый ключ «не подхватывается».

Какой ключ вы получите. По странице о ключах Gemini API (обновлена 6 октября 2026 года) с 28 мая 2026 года AI Studio создаёт только auth keys. Такой ключ привязан к сервисному аккаунту Google Cloud, по умолчанию ограничен одним Gemini API, а при утечке Google блокирует его быстрее, чем обычный ключ. Ограничивать его вручную не нужно.

Если ключ создан раньше. Стандартные ключи с явными ограничениями продолжают работать, а запросы с ключей без ограничений Gemini API отклоняет. Кроме того, с 7 мая 2026 года долго не использовавшиеся ключи без ограничений блокируются и получают в AI Studio метку Blocked. Есть два выхода: включить для старого ключа Restrict to Gemini API only в AI Studio (или ограничить API в Cloud Console) либо создать новый ключ, переключить на него приложение, проверить работу и удалить старый.

Проверить, что ключ принимается, можно запросом списка моделей. Ключ передаётся в заголовке x-goog-api-key, как в примерах Google:

curl "https://generativelanguage.googleapis.com/v1beta/models" \
  -H "x-goog-api-key: $GEMINI_API_KEY"

JSON со списком моделей означает, что ключ действителен. Ошибка аутентификации — повод проверить, тот ли ключ лежит в переменной и нет ли в нём лишних пробелов или переноса строки. Успешный ответ ещё не значит, что заработает генерация картинок: для неё нужен следующий шаг.

Шаг 2. Подключите оплату: без Paid Tier картинок не будет

На странице цен Gemini API в колонке Free Tier у Nano Banana Pro, Nano Banana 2, 2.1 и 2 Lite стоит «Not available». Бесплатных запросов к моделям изображений нет, и подписки Google AI Pro или Ultra квоту API не добавляют. Поэтому до первой картинки проект нужно перевести на платный уровень.

Порядок по документации о биллинге Gemini API (обновлена 28 сентября 2026 года):

1. На странице API keys или Projects в AI Studio найдите проект и нажмите Set up billing в колонке Billing Tier.
2. Если платёжного аккаунта Google у вас ещё нет, выберите страну, примите условия, укажите контакты и способ оплаты. Если есть — выберите существующий аккаунт или создайте новый через Add new billing account.
3. Внесите предоплату от $5 (или эквивалент в другой валюте). Части аккаунтов вместо этого предлагают выбор между Prepay и Postpay или временно назначают Postpay, пока новая система предоплаты не дошла до всех.

Что важно знать о предоплате:

• Стоимость запросов списывается с баланса почти в реальном времени. Разовое пополнение — от $5 до $5 000, неиспользованные кредиты сгорают через 12 месяцев.
• Когда баланс доходит до $0, перестают работать все ключи во всех проектах, привязанных к этому платёжному аккаунту, и запросы получают HTTP 402 Payment Required. Чтобы не попасть в такую ситуацию посреди работы, включите автопополнение (auto-reload) с месячным лимитом.
• Промокредиты Google Cloud при предоплате начинают тратиться только после того, как вы купили кредиты; дальше они расходуются раньше предоплаченного баланса.
• Статус видно на странице Projects: «Set up billing» — платёжный аккаунт не привязан, «Set up Prepay» — нужно настроить предоплату, «No credits» — кредиты не куплены или закончились.
• Аккаунты, которые сейчас работают по постоплате, Google переводит на предоплату. Дата перехода указана в уведомлении вашего аккаунта; Impress Watch сообщала о 12 октября 2026 года. Аккаунтам, которые пользуются только бесплатными функциями, ничего делать не нужно. Подробнее о предоплате, постоплате и уровнях — в статье Оплата Gemini API: предоплата, постоплата, уровни и ошибка 402.

Уровни и месячные потолки расходов. Уровень определяется не проектом, а платёжным аккаунтом: по сумме оплат и времени с первого успешного платежа. Переход на следующий уровень происходит автоматически.

Для отдельного проекта можно задать свой месячный лимит: в AI Studio на странице Spend → Monthly spend cap. Функция экспериментальная, и из-за задержки около 10 минут расход может ненадолго превысить лимит. Использование видно в AI Studio в разделе Dashboard → Usage.

Шаг 3. Первая картинка с gemini-3-pro-image: Python, Node.js и REST

Примеры ниже повторяют образцы из руководства Google по генерации изображений на 8 октября 2026 года: вызов через Interactions API, ID модели заменён на gemini-3-pro-image, добавлены соотношение сторон и размер. Размер пишется с заглавной K (1K, 2K, 4K); строчные значения вроде 2k API отклоняет.

Python (google-genai)

pip install -U google-genai

import base64
from google import genai

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

interaction = client.interactions.create(
    model="gemini-3-pro-image",
    input="A minimalist poster of a banana-shaped rocket over a night city, "
          "with the headline 'NANO BANANA PRO' in bold sans-serif letters",
    response_format={
        "type": "image",
        "mime_type": "image/png",
        "aspect_ratio": "16:9",
        "image_size": "2K",
    },
)

if interaction.output_image is None:
    raise SystemExit("Картинки в ответе нет: проверьте причину блокировки")

with open("nano-banana-pro.png", "wb") as f:
    f.write(base64.b64decode(interaction.output_image.data))
print("Сохранено: nano-banana-pro.png")

Node.js (@google/genai)

npm install @google/genai

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

async function main() {
  const ai = new GoogleGenAI({}); // ключ из GEMINI_API_KEY или GOOGLE_API_KEY

  const interaction = await ai.interactions.create({
    model: "gemini-3-pro-image",
    input:
      "A minimalist poster of a banana-shaped rocket over a night city, " +
      "with the headline 'NANO BANANA PRO' in bold sans-serif letters",
    response_format: {
      type: "image",
      mime_type: "image/png",
      aspect_ratio: "16:9",
      image_size: "2K",
    },
  });

  const image = interaction.output_image;
  if (!image) {
    throw new Error("Картинки в ответе нет: проверьте причину блокировки");
  }
  fs.writeFileSync("nano-banana-pro.png", Buffer.from(image.data, "base64"));
  console.log("Сохранено: nano-banana-pro.png");
}

main();

REST (cURL)

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-3-pro-image",
    "input": [
      {"type": "text", "text": "A minimalist poster of a banana-shaped rocket over a night city, with the headline NANO BANANA PRO"}
    ],
    "response_format": {
      "type": "image",
      "mime_type": "image/png",
      "aspect_ratio": "16:9",
      "image_size": "2K"
    }
  }' -o response.json

Картинка приходит в ответе в base64; в SDK это поле output_image. Сохраняйте её сразу: API отдаёт изображение в теле ответа, а не ссылкой.

Pro — модель с размышлениями, поэтому до финального результата она может создать до двух промежуточных изображений. Их видно при разборе шагов ответа (interaction.steps), а итог лежит в output_image. Почему так происходит и как не перепутать промежуточный кадр с финальным, объясняет статья Временные изображения Nano Banana и исправление ошибок.

Если код уже написан на generateContent

generateContent Google продолжает полностью поддерживать, переписывать рабочий код на Interactions API не обязательно. Обязательно заменить ID модели: с 25 июня 2026 года запросы к gemini-3-pro-image-preview не проходят.

# было
model="gemini-3-pro-image-preview",
# стало
model="gemini-3-pro-image",

В REST-запросах к generateContent ID стоит прямо в адресе (.../models/gemini-3-pro-image:generateContent), а ключ лучше передавать заголовком x-goog-api-key, как в документации Google.

Ошибки при первом запуске: 401, 402, 404 и 429

Коды зависят от того, какой API вы вызываете. Справочник ошибок Gemini API (обновлён 20 сентября 2026 года) перечисляет коды Interactions API, а generateContent по-прежнему возвращает статусы в стиле gRPC: например, неверный ключ там даёт INVALID_ARGUMENT 400 с текстом «API key not valid», а исчерпанный лимит — RESOURCE_EXHAUSTED 429.

Отдельно про 429 в проекте без оплаты: у бесплатного уровня нет квоты на модели изображений, поэтому запрос выглядит как исчерпанный лимит, хотя на самом деле нужен Шаг 2. Как по тексту ошибки отличить поминутный лимит от суточной квоты, нулевой квоты бесплатного проекта и лимита расходов за 10 минут, разбирают статьи Ошибка 429 Gemini при генерации изображений: какой лимит сработал и Nano Banana Pro: ошибка RESOURCE_EXHAUSTED и восстановление генерации. Ответ 200 без картинки подробно разобран в материале Nano Banana не генерирует изображение в API: как найти причину, а как Google разделяет блокировки контента, лимиты и меры против аккаунта — в статье Блокировки Nano Banana Pro: контент, лимиты, аккаунт и регион.

Повторы: какие ошибки повторять и как включить их в SDK

Страница по устранению неполадок Gemini API (обновлена 1 октября 2026 года) советует повторять только временные ошибки — 429, 408 и 5xx — с экспоненциальной задержкой, случайным разбросом (jitter) и ограничением числа попыток. Ошибки 400, 402 и 403 повторять бессмысленно: запрос сначала нужно исправить или пополнить баланс.

Там же сказано, что Python SDK сам повторяет временные ошибки до четырёх раз. Проверка google-genai 2.28.0 5 октября 2026 года на локальном сервере, отвечавшем 429, показала другое: client.models.generate_content с клиентом по умолчанию отправил один запрос и сразу выбросил исключение, а client.interactions.create повторил запрос трижды. Если вы остаётесь на generateContent, включите повторы явно:

from google import genai
from google.genai import types

client = genai.Client(
    http_options=types.HttpOptions(retry_options=types.HttpRetryOptions())
)

Полный разбор кодов с примерами ответов собран в руководстве по ошибкам Nano Banana Pro. Февральские материалы о кодах ошибок Nano Banana Pro и устранении неполадок Nano Banana Pro полезны для понимания 503 и фильтров безопасности, но ID модели в их примерах нужно заменить так же, как здесь.

Сколько стоит Nano Banana Pro в API: $0,134 за 1K/2K и $0,24 за 4K

Цены за одно сгенерированное изображение по странице цен Gemini API на 10 октября 2026 года. В Vertex AI они такие же.

Откуда берутся цифры Pro: выходные токены изображения стоят $120 за 1 млн, картинка 1K или 2K — это 1 120 токенов, то есть 1 120 × $120 / 1 000 000 = $0,1344, а 4K — 2 000 токенов, или $0,24. Сверху оплачиваются вход ($2 за 1 млн токенов, одно входное изображение — около $0,0011) и токены текста и размышлений ($12 за 1 млн). Привязка к Google Поиску даёт 5 000 бесплатных запросов в месяц на все модели Gemini 3.x, дальше — $14 за 1 000.

Для ориентира: 1 000 картинок Pro в 1K стоят 1 000 × $0,134 = $134, через Batch — $67, без учёта размышлений и входа. Те же 1 000 картинок у Nano Banana 2.1 в 1K — $33,60 и $16,80 соответственно.

Batch — задокументированный способ платить вдвое меньше, если результат не нужен сразу. Режим Flex для Pro на странице цен указан по цене Batch, но в документации по Flex моделей изображений в списке поддерживаемых нет, поэтому рассчитывать на него не стоит. Подробный расчёт с размышлениями и сценариями — в статье Стоимость Gemini 3 Pro Image API: $0,134 за 1K/2K, $0,24 за 4K.

Первая модель семейства, gemini-2.5-flash-image («Nano Banana Flash», $0,039 за картинку), для новых проектов не подходит: в журнале изменений Gemini API её отключение датировано 2 октября 2026 года, хотя таблица устаревших моделей на 10 октября 2026 года ещё называет 15 марта 2027 года.

У сторонних платформ свои цены. LaoZhang API по своей документации о моделях Nano Banana на 7 октября 2026 года берёт за вызов gemini-3-pro-image $0,09 при любом размере и уровне размышлений, а за gemini-nano-banana-2.1 — $0,045. Это отдельный договор со своим ключом и балансом, а не ключ Google, и ответ 200 без картинки там списывается как обычный вызов. Как цена Pro в API соотносится с подпиской и с Nano Banana 2.1, разобрано в статье Сколько стоит Nano Banana Pro: $0,134 в API, подписка или 2.1.

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

Квота Nano Banana Pro API: где посмотреть лимиты и как их поднять

Лимиты Gemini API считаются на проект, а не на ключ, поэтому второй ключ в том же проекте квоту не удваивает. Публичной таблицы RPM и IPM (изображений в минуту) для Pro у Google нет: действующие значения видны только в AI Studio, на странице «View your active rate limits». По странице лимитов Gemini API (по состоянию на 10 октября 2026 года) действуют ещё два ограничения:

• Лимит расходов за скользящие 10 минут: Tier 1 — $10, Tier 2 — $50, Tier 3 — $200. При его превышении приходит 429 RESOURCE_EXHAUSTED. При цене $0,134 это около 74 картинок 1K за 10 минут на Tier 1 ($10 / $0,134), без учёта размышлений.
• Очередь Batch для Gemini 3 Pro Image: 2 000 000 токенов на Tier 1, 270 млн на Tier 2 и 1 млрд на Tier 3. На странице модель всё ещё подписана как Preview.

Поднять квоту можно двумя путями: дождаться автоматического перехода на следующий уровень (Tier 2 — $100 оплаты и 3 дня) или отправить запрос на увеличение лимита. Оба пути со сроками и пересчётом в картинки описаны в статье Квота Nano Banana Pro API: как увеличить и сколько это картинок, а общая логика уровней — в материале Лимиты Gemini API: где смотреть, уровни Tier 1–3 и ошибки 429.

Как защитить ключ Nano Banana Pro от утечки и лишних расходов

Все запросы с вашего ключа списываются с вашего баланса, кто бы их ни отправил. Минимальный набор мер:

• Ключ — только в переменных окружения или менеджере секретов. Файл .env сразу добавьте в .gitignore. Google прямо предупреждает: не коммитить ключи в Git и не вшивать их в веб- и мобильные приложения. Если запросы идут из браузера или телефона, ставьте между клиентом и Gemini API свой сервер.
• Ограничения. Auth key уже ограничен Gemini API. Старый стандартный ключ ограничьте сами (Restrict to Gemini API only), а для сервера добавьте ограничение по IP.
• Отдельный ключ для каждого приложения и среды. Тогда утечка одного ключа не остановит остальные, а замену можно провести без простоя: создать новый ключ, переключить приложение, проверить и удалить старый.
• Потолок расходов. Месячный лимит проекта (Spend → Monthly spend cap) и автопополнение с месячным лимитом ограничат ущерб, если ключ всё же утечёт. Помните о задержке около 10 минут: короткий всплеск расходов лимит не остановит мгновенно.
• Контроль расхода. Резкий рост запросов в Dashboard → Usage в часы, когда приложение должно простаивать, — повод сразу заменить ключ.

Вопросы о ключе Nano Banana Pro API

Бесплатен ли Nano Banana Pro API?

Нет. Ключ создаётся бесплатно, но у моделей изображений в Gemini API нет бесплатного уровня: первая картинка требует платного проекта и, для нового аккаунта, предоплаты от $5. Подписки Google AI Pro и Ultra квоту API не добавляют. Где Nano Banana Pro можно попробовать без оплаты API — в приложении Gemini и других сервисах Google, — разобрано в статье Nano Banana Pro бесплатен? Gemini, Flow и API: лимиты по планам, а все бесплатные варианты для API — в материале Gemini Image API бесплатно? Нет: картинки от $0,0336 за штуку.

Покрывают ли $300 пробного периода Google Cloud картинки Nano Banana Pro?

Нет, если вы работаете через ключ AI Studio. С марта 2026 года расходы на Gemini API исключены из программы Google Cloud Free Trial на $300, а приветственными кредитами Google Cloud нельзя оплатить использование AI Studio, так что для первой картинки всё равно нужна предоплата от $5. Страница программы Free Trial модели Gemini в Vertex AI не исключает, но прямого подтверждения, что пробные кредиты покрывают там Nano Banana Pro, Google не публикует.

Можно ли бесплатно пользоваться Nano Banana Pro в AI Studio?

Сама AI Studio бесплатна, пока к ней не привязан платный API-ключ, но модели изображений в её Playground открываются только с планом Google AI или с ключом. Подписка Google AI Pro, по описанию Google, даёт в AI Studio доступ к премиальным моделям, включая Nano Banana, и более высокие лимиты, однако только в веб-интерфейсе: запросы к Gemini API с вашего ключа оплачиваются отдельно, по ценам из раздела выше.

Работает ли ключ, созданный до 28 мая 2026 года?

Да, если у него есть явные ограничения API. Стандартный ключ без ограничений Gemini API отклонит, а если таким ключом долго не пользовались, с 7 мая 2026 года он мог получить метку Blocked. Ограничьте ключ через Restrict to Gemini API only или создайте новый auth key.

Почему Nano Banana Pro отвечает «модель не найдена»?

Почти всегда в коде остался gemini-3-pro-image-preview. Этот ID отключён 25 июня 2026 года; замените его на gemini-3-pro-image. То же касается gemini-3.1-flash-image-preview: Google предлагает вместо него gemini-nano-banana-2.1.

Сколько ключей создавать для нескольких приложений?

По одному на приложение и среду (разработка, тестирование, продакшн). Квоту это не увеличит, потому что лимиты считаются на проект, зато утечку одного ключа можно закрыть, не останавливая остальные. Независимым приложениям с отдельным бюджетом удобнее дать отдельные проекты.

Можно ли вызывать Nano Banana Pro через Vertex AI вместо ключа AI Studio?

Да. В Vertex AI модель называется так же, gemini-3-pro-image, цены за изображение совпадают с Gemini API, а вместо ключа AI Studio используются учётные данные Google Cloud (сервисный аккаунт). Прекращение поддержки gemini-3-pro-image в Vertex AI Google назначил не раньше 28 мая 2027 года. Настройка SDK, выбор location и разбор ошибок — в статье Nano Banana API в Vertex AI: рабочие модели, настройка и цена; обзор всех моделей семейства — в материале Nano Banana API: документация, ключ и пошаговая инструкция.