Как подключить Nano Banana Pro: доступ, ключ и модель

Как подключить Nano Banana Pro: взять ключ Gemini API в Google AI Studio, убрать его в переменную окружения и указать в запросе имя модели gemini-3-pro-image. Отдельного сервиса с таким названием не существует: Nano Banana Pro - это имя, под которым Google продаёт свою модель Gemini 3 Pro Image. Главная засада ждёт не в коде: у этой модели нет бесплатного уровня, проект должен быть на платном.

Проверено: 24 октября 2026.

Меня зовут Анастасия Майер, я архитектор контент-заводов и инженер по искусственному интеллекту: 20 систем под ключ в 10 нишах. Генерация картинок стоит у меня в конвейере потоком - обложки статей, превью роликов, карточки для соцсетей, - и Pro-модель я беру ровно там, где дешёвая не справляется: сложная сцена, точный шрифт на картинке, узнаваемый стиль бренда из раза в раз.

Ниже - к чему вы подключаетесь, почему подключение ломается на первом шаге, восемь шагов до первой картинки, что указать в запросе кроме имени модели, сколько за это списывают и как читать отказы. Свои связки и грабли выкладываю в Telegram-канале.

Что такое Nano Banana Pro и к чему вы подключаетесь

Коротко: Nano Banana - имя встроенной генерации изображений Gemini, а Pro - старшая модель этого семейства, Gemini 3 Pro Image.

Сервиса с вывеской Nano Banana Pro нет. Google документирует одно семейство моделей, которые рисуют, и каждая живёт в Gemini API под своим техническим именем:

• gemini-3-pro-image - Nano Banana Pro, он же Gemini 3 Pro Image. Google описывает его как премиальный выбор под самые сложные визуальные задачи: наибольшее знание мира, продвинутая локализация, точное попадание в фирменный стиль и тонкий творческий контроль.
• gemini-nano-banana-2.1 - Nano Banana 2.1, основная рабочая лошадка: скорость и цена уровня Flash при подтянутом качестве, тексте на картинке и консистентности в диалоге.
• gemini-3.1-flash-lite-image - Nano Banana 2 Lite, самая быстрая и дешёвая. Умеет только разрешение 1K.
• gemini-3.1-flash-image - Nano Banana 2, предыдущая рабочая лошадка. Новым проектам Google советует сразу версию 2.1.
• gemini-2.5-flash-image - первая Nano Banana, для неё описан переход на Lite.

Отсюда первый практический вывод: подключаетесь вы к Gemini API, а Pro появляется в момент, когда вы пишете имя модели в запросе. Доступ, ключ, проект и оплата у всего семейства общие. Второе: на каждой сгенерированной картинке стоит водяной знак SynthID, он есть у всех моделей семейства.

Дверей внутрь три. Попробовать без кода - в Google AI Studio, модель там доступна для теста. Поставить в конвейер - через ключ Gemini API, про это вся инструкция ниже. Третья - Gemini Enterprise Agent Platform, корпоративный путь с договором, куда Google отправляет тех, чьей страны нет в списке.

Почему подключение ломается на первом шаге

Коротко: четыре причины - страна, бесплатный уровень, тип ключа и имя модели. Первые две настройками не лечатся.

Страна. Google AI Studio и Gemini API работают в списке стран и территорий, который Google публикует отдельной страницей. России в этом списке нет, и тех, кто не нашёл свою страну, документация отправляет в Gemini Enterprise Agent Platform. Инструкций, как обмануть проверку региона, я не даю: это нарушает условия сервиса, а в России попадает под закон о пропаганде обхода блокировок. Законные варианты - в разделе «Если не получилось».

Бесплатный уровень. У Gemini 3 Pro Image в прайсе Google в колонке бесплатного уровня стоит прочерк и по входу, и по выходу. Работает модель только на платном уровне проекта. Отдельно Google предупреждает, что право на бесплатный уровень вообще оценивается на уровне проекта Google Cloud: если проект его лишён, новый ключ в том же проекте ничего не изменит.

Тип ключа. Google переводит Gemini API со старых ключей на ключи авторизации. С 28 мая 2026 года все новые ключи в AI Studio создаются уже как ключи авторизации: они привязаны к сервисному аккаунту, по умолчанию ограничены только Gemini API и быстро гасятся, если утекли. Запросы от старых ключей без ограничений Gemini API отклоняет. Если у вас в проекте лежит ключ годичной давности без ограничений, он не заработает, и выглядит это как «ключ правильный, а доступа нет».

Имя модели. Пишется строго как в документации: короткое «nano banana pro» в поле модели не поймут, придёт ошибка о ненайденной модели. Актуальные имена - в списке выше и на странице моделей Google.

Как подключить Nano Banana Pro: по шагам

Коротко: восемь шагов - от входа в AI Studio до первой картинки. Почти всё делается в браузере, кода тут одна строка.

Шаг 1. Откройте Google AI Studio и примите условия. Новому пользователю AI Studio сам создаёт проект Google Cloud по умолчанию и первый ключ к нему. Переименовать проект можно в разделе проектов на панели.

Шаг 2. Если аккаунт Google Cloud у вас уже есть, импортируйте проект. Проект по умолчанию в этом случае не создаётся, и своих проектов AI Studio сначала не показывает. Откройте панель, раздел проектов, кнопку импорта, найдите нужный проект и подтвердите импорт.

Шаг 3. Создайте ключ на странице ключей. Она в той же панели AI Studio. Ключ выпускается внутри выбранного проекта, и это важнее, чем кажется: лимиты и оплата считаются по проекту.

Шаг 4. Если кнопка создания ключа серая. Google пишет рядом, что прав на создание ключа в этом проекте у вас нет: в Google Cloud не хватает ролей. Попросите администратора выдать роль с правами на просмотр проекта, создание ключей, включение сервисов, создание сервисного аккаунта и привязку ключа к нему. Администратора нет - заведите новый проект Google Cloud вне организации и выпускайте ключ там.

Шаг 5. Переведите проект на платный уровень. Бесплатного уровня у Pro-модели нет, значит проекту нужен активный платёжный аккаунт Cloud Billing. Google отдельно предупреждает: платный уровень не открывает квоту бесплатного.

Шаг 6. Уберите ключ в переменную окружения. Клиентские библиотеки Google сами подхватывают переменную с этим именем:

GEMINI_API_KEY

Второе рабочее имя - GOOGLE_API_KEY. Если заданы оба, приоритет у второго. Передавать ключ строкой в коде Google советует только в случаях, когда переменную использовать нельзя.

Шаг 7. Проверьте доступ самым дешёвым способом. Сначала попробуйте модель в AI Studio руками: рисуется картинка - дело не в доступе. И запомните тонкость из документации: служебные запросы вроде списка моделей проверяют только существование ключа и ничего не знают о платном уровне и состоянии оплаты. Ключ «работает», а генерация падает - это ровно тот случай.

Шаг 8. Отправьте первый запрос с именем модели. В поле модели ставится:

gemini-3-pro-image

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

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

Что указать в запросе, кроме имени модели

Коротко: размер, формат кадра и референсы. Остальное модель решает сама, и отключить это нельзя.

Размер. По умолчанию Gemini 3 рисует 1K. Для 2K и 4K размер указывается отдельным полем в формате ответа. Буква K в значении заглавная: строчное «1k» документация отклоняет. У версии Lite выбора нет, там только 1K.

Формат кадра. Соотношение сторон задаётся там же, рядом с размером: 16:9, 1:1, 5:4 и другие. Для блога и соцсетей это самое полезное поле: один запрос отдаёт и обложку статьи, и квадрат под ленту.

Референсы. Модели семейства смешивают до четырнадцати референсных картинок в одной генерации: объекты, персонажей, образцы стиля. На этом и держится узнаваемость - товар, лицо креатора и фирменная палитра приезжают в кадр с ваших файлов.

Мышление. Рисующие модели Gemini 3 думают перед ответом, и в API это включено по умолчанию и не выключается. Модель делает до двух промежуточных картинок, чтобы проверить композицию и логику; последняя из них и становится финальной. Промежуточные Google не тарифицирует, а саму цепочку можно прочитать в шагах ответа.

Проверка фактов поиском. Pro-модель умеет брать Google Search инструментом и рисовать по свежим данным: карта погоды, график, событие недели. Удобно, но это отдельная строка в счёте.

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

Сколько стоит и за что списывают деньги

Коротко: бесплатного уровня нет, картинка 1K или 2K стоит около 13 центов, 4K - около 24 центов, пакетный режим вдвое дешевле.

Цифры из прайса Google на день проверки, платный уровень, за миллион токенов:

• Вход - 2 доллара за текст и картинки на входе. В пересчёте это примерно 0,0011 доллара за одну входную картинку.
• Выход, текст и мышление - 12 долларов.
• Выход, картинки - 120 долларов. В пересчёте примерно 0,134 доллара за картинку 1K или 2K и 0,24 доллара за 4K.
• Пакетный режим - вход 1 доллар за текст и 0,0006 за входную картинку, выход 6 долларов за текст и мышление, 0,067 за картинку 1K или 2K, 0,12 за 4K.
• Проверка фактов поиском - 5000 запросов в месяц бесплатно на все модели Gemini 3 и новее вместе, дальше 14 долларов за тысячу запросов.

Текстовый вход и выход у этой модели считаются по тем же ставкам, что у Gemini 3.1 Pro.

Переведите это на свой месяц. Сто обложек в 2K обычным режимом - около 13 долларов, пакетным - около 7. Цена часа дизайнера, и за неё вы получаете поток. А если конвейер гонит 4K там, где хватает 1K, счёт растёт вдвое ни за что: в ленте разницы не видно. Такие пересчёты я и показываю на консультации: дорого обычно выходит не модель, а лишние шаги вокруг неё.

Частые ошибки и что они значат

Коротко: код отказа сразу говорит, чья это проблема - страны, проекта, оплаты, ключа или лимита.

• 403, доступ проекту закрыт - в AI Studio у проекта стоит статус с ограничением. Google называет четыре: ограничен, бесплатный уровень недоступен, нужна оплата, недоступен. Новый ключ тут не поможет, разбирайте статус.
• 403, бесплатный уровень недоступен - проект не имеет права на бесплатный уровень. Второй ключ в том же проекте не поможет: право оценивается по проекту. Выход - платный уровень через активный платёжный аккаунт.
• 403, нужна оплата - у платёжного аккаунта долг или просроченный способ оплаты. Как только аккаунт вернётся в нормальное состояние, доступ к API восстанавливается сам.
• 403, ключ помечен как утёкший или заблокированный - выпускайте новый на странице ключей и меняйте во всех местах сразу. И не держите ключ в коде, который уходит на клиент или в публичный репозиторий.
• 404, модель не найдена - опечатка в имени модели или имя, которого больше нет. Сверьтесь со страницей моделей.
• 429, кончились лимиты - повторяйте с нарастающей паузой. Официальная питоновская библиотека Google делает это сама: до четырёх повторов, начальная задержка около секунды, максимальная около минуты.
• 503, сервис недоступен - перегрузка на стороне Google. Тоже повтор с паузой.

Отдельное правило: ошибки 400, 402 и 403 повторять бесполезно. Они про ваш запрос, кошелёк и доступ, от десятого повтора ничего не изменится. Полный разбор отказов самой генерации - фильтры, пустой ответ, коды блокировки - в статье не работает nano banana.

Если не получилось

Коротко: если дело в стране, настройками это не чинится, и законных путей три.

Начну с того, чего делать не стоит. Обходить проверку региона, подсовывать чужие платёжные данные, покупать доступ у случайных продавцов в чатах - нарушение условий сервиса и риск потерять и проект, и деньги. Таких инструкций я не даю.

Законные варианты:

• Российские генераторы картинок. Платите картой, доступ добывать не надо. Для обложек, карточек товара и превью роликов качества обычно хватает с запасом.
• Официальные агрегаторы доступа к зарубежным моделям, работающие в России по договору. Вы платите рублями юридическому лицу, оно отвечает за доступ и оплату.
• Gemini Enterprise Agent Platform. Корпоративный путь, на который Google сам указывает тем, чьей страны нет в списке.

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

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

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

Коротко: то, что спрашивают сразу после первого запроса.

Nano Banana Pro - это отдельный сервис? Нет. Это имя модели Gemini 3 Pro Image внутри Gemini API, техническое имя gemini-3-pro-image.

Можно попробовать Nano Banana Pro бесплатно? В прайсе Google у этой модели бесплатного уровня нет ни по входу, ни по выходу. Попробовать её руками можно в Google AI Studio, а работа через API идёт только на платном уровне.

Чем Pro отличается от обычной Nano Banana? Google описывает Pro как премиальную модель под сложные задачи: больше знания о мире, аккуратнее локализация, точнее фирменный стиль. Для обложек потоком дешевле версия 2.1.

Не хотите разбираться сами

Коротко: подключение занимает вечер, а конвейер вокруг него - отдельная работа, и её можно отдать.

Первая картинка по этой инструкции получается за вечер. Дальше начинается то, за что платят: единый стиль у сотни обложек, автоподстановка в статьи и карточки, запасной путь на случай отказа сервиса, учёт расходов. Один ручной шаг тут стоит недорого, но повторяется каждый день.

Собрать такую связку под вашу задачу - это ИИ-разработка. Не ясно, нужна ли автоматизация вообще, - приходите на бесплатный созвон на 20 минут: если задача решается руками за полчаса, я так и скажу.

Я, Анастасия Майер, держу одно правило по инструментам: в конвейер идёт то, что не требует человека на каждом запуске. Про соседние доступы - в статьях как получить API-ключ DeepSeek и как зарегистрироваться в Claude из России, а свои связки и счета за нейросети участники разбирают в клубе Майер.

Источники

• Google, Nano Banana image generation - семейство и технические имена моделей, описание Gemini 3 Pro Image, знак SynthID, размеры 1K, 2K и 4K и правило заглавной K, соотношения сторон, четырнадцать референсов, мышление с промежуточными картинками, проверка фактов поиском. Проверено 24 октября 2026.
• Google, Using Gemini API keys - проект Google Cloud по умолчанию и импорт своих проектов, страница ключей, ключи авторизации с 28 мая 2026 года, отклонение старых ключей без ограничений, права IAM, переменные GEMINI_API_KEY и GOOGLE_API_KEY.
• Google, Available regions - список поддерживаемых стран и территорий и переход в Gemini Enterprise Agent Platform для остальных.
• Google, Gemini API pricing - прочерк в бесплатном уровне у Gemini 3 Pro Image, ставки платного и пакетного режимов, цена картинки 1K, 2K и 4K, лимит бесплатных поисковых запросов.
• Google, API errors - коды 402, 403, 404 и 429 и что делать с каждым.
• Google, API troubleshooting - статусы проекта, отказы по бесплатному уровню и оплате, утёкшие ключи, повторы с нарастающей паузой и коды, которые повторять бесполезно.
• Моя практика генерации обложек и превью в контент-заводах.