Чтобы получить Nano Banana Pro API key, откройте Google AI Studio, войдите через свой аккаунт Google и нажмите «Create API Key». Ключ работает с моделью gemini-3-pro-image-preview, генерируя изображения стоимостью приблизительно $0,134 за изображение в стандартном разрешении и $0,24 за 4K по состоянию на февраль 2026 года. Один критически важный момент, который упускают большинство руководств: генерация изображений требует подключённого биллинга в вашем проекте Google Cloud (Tier 1 или выше) — бесплатный уровень API не поддерживает вывод изображений. Это руководство проведёт вас через весь процесс — от создания API key до генерации первого изображения — с полными примерами кода на Python, Node.js и REST API.
Краткое содержание
Получение Nano Banana Pro API key занимает менее 5 минут, однако для успешной генерации первого изображения необходимо понимать несколько ключевых шагов, на которых спотыкается большинство разработчиков. Вам нужно создать ключ на aistudio.google.com/apikey, подключить биллинг к проекту Google Cloud (бесплатный уровень не позволяет генерировать изображения), установить предпочитаемый SDK и использовать идентификатор модели gemini-3-pro-image-preview. Стоимость составляет приблизительно $0,134 за изображение в разрешении 1K/2K, а Batch API предлагает скидку 50%. Данное руководство охватывает каждый шаг с работающим кодом на трёх языках, лучшими практиками безопасности и полным разбором цен, верифицированным по официальной документации Google в феврале 2026 года.
Что такое Nano Banana Pro и зачем нужен API Key?
Прежде чем переходить к шагам настройки, стоит разобраться, к чему именно вы настраиваете доступ и почему API key необходим. Этот контекст поможет вам принять правильные решения относительно выбора модели, конфигурации проекта и оптимизации затрат с самого начала.
Nano Banana Pro — это флагманская модель генерации изображений с помощью ИИ в семействе Google Gemini, идентифицируемая по model ID gemini-3-pro-image-preview (официальная документация Google AI, февраль 2026). В отличие от традиционных текстовых моделей ИИ, Nano Banana Pro является нативно мультимодальной моделью, способной одновременно понимать и генерировать изображения в рамках одного контекста разговора. Это означает, что вы можете отправить ей текстовый промпт и получить в ответ высококачественное изображение, либо отправить существующее изображение с просьбой модифицировать, расширить или переосмыслить его.
Различие между Nano Banana Pro и её родственной моделью Nano Banana (Flash) существенно и заслуживает понимания до получения API key. Nano Banana Pro поддерживает разрешение до 4K (4096x4096 пикселей), обладает функцией рассуждающей генерации изображений через режим Thinking и может использовать поисковое обоснование (search grounding) для обеспечения реалистичности при создании изображений. Вариант Flash, использующий model ID gemini-2.5-flash-image, генерирует изображения примерно в три раза дешевле ($0,039 за изображение против $0,134), но ограничивает вас более низким разрешением и лишён режима Thinking и поддержки 4K. Подробный разбор этих различий вы найдёте в полном сравнении бесплатного и платного уровней.
Что делает Nano Banana Pro особенно мощной по сравнению с автономными генераторами изображений — это её нативная мультимодальность. Вы можете предоставить до 14 референсных изображений в одном запросе, что позволяет решать задачи переноса стиля, редактирования изображений и визуальной композиции, которые в других конвейерах потребовали бы нескольких инструментов. Модель также поддерживает структурированный вывод в формате JSON, что полезно при необходимости сочетать генерацию изображений с извлечением метаданных или автоматизированными постобработочными рабочими процессами. Её контекстное окно ввода принимает до 65 536 токенов, а вывод может достигать 32 768 токенов (ai.google.dev/models, февраль 2026), предоставляя значительный простор для сложных многоходовых диалогов, включающих как текстовые рассуждения, так и создание изображений.
API key — это ваши аутентификационные данные: он сообщает серверам Google, что у вас есть разрешение на доступ к Gemini API. Без него каждый запрос к API будет отклонён. Сам ключ представляет собой строку символов (обычно начинающуюся с «AIza»), которую вы включаете в HTTP-запросы — либо как параметр запроса, либо в заголовке. Каждый ключ привязан к конкретному проекту Google Cloud, который определяет ваш биллинг, лимиты запросов и доступные квоты. Вы можете создать несколько ключей для одного проекта, что удобно для разделения различных приложений или сред (например, разработка и продакшн). Понимание этой связи между ключами и проектами важно, потому что лимиты запросов, биллинг и отслеживание использования происходят на уровне проекта, а не ключа — создание второго ключа для того же проекта не удваивает ваши квоты.
Пошаговая инструкция: получите Nano Banana Pro API Key за 5 минут
Самый быстрый путь к получению API key лежит через Google AI Studio — удобный для разработчиков интерфейс Google для работы с Gemini API. Хотя управлять API-ключами можно и через Google Cloud Console, AI Studio значительно упрощает процесс и является методом, рекомендуемым самой документацией Google.
Шаг 1: войдите в Google AI Studio. Перейдите на aistudio.google.com и войдите через свой аккаунт Google. Подойдёт любой стандартный аккаунт Gmail или Google Workspace — отдельная учётная запись Google Cloud для начала работы не нужна. Если вы посещаете AI Studio впервые, вас могут попросить принять условия использования. Интерфейс отобразит ваши существующие проекты и API-ключи, если они есть.
Шаг 2: перейдите на страницу API Key. Нажмите кнопку «Get API Key» в боковой панели или перейдите напрямую по адресу aistudio.google.com/apikey. На этой странице отображаются все API-ключи, связанные с вашими проектами Google Cloud. Если вы никогда ранее не создавали проект Google Cloud, AI Studio может создать его автоматически на следующем шаге.
Шаг 3: создайте API key. Нажмите кнопку «Create API Key». Вы увидите два варианта: создать ключ в новом проекте или создать ключ в существующем проекте. Для большинства разработчиков, только начинающих работу, выбор «Create API key in new project» — самый простой путь. AI Studio автоматически создаст проект Google Cloud, активирует Generative Language API и сгенерирует ваш API key — всё в одном клике. Весь процесс занимает около 10 секунд.
Шаг 4: скопируйте и надёжно сохраните ключ. После генерации ваш API key отобразится на экране. Нажмите кнопку копирования, чтобы скопировать его в буфер обмена. Это критически важно: немедленно сохраните API key в надёжном месте. Не вставляйте его напрямую в исходный код, не коммитьте в систему контроля версий и не публикуйте открыто. Рекомендуемый подход — хранить его в переменной окружения (подробнее в разделе «Безопасность» ниже). Ваш ключ будет выглядеть примерно как AIzaSyD..., за которым следуют ещё приблизительно 35 символов.
После копирования ключа вы можете убедиться, что он работает, выполнив быструю проверку. Откройте терминал и выполните эту команду cURL, заменив YOUR_API_KEY на только что скопированный ключ:
bashcurl "https://generativelanguage.googleapis.com/v1beta/models?key=YOUR_API_KEY"
Если ключ действителен, вы получите JSON-ответ со списком доступных моделей, включая gemini-3-pro-image-preview. Если вы получили ошибку, проверьте, что скопировали весь ключ целиком, без лишних пробелов или переносов строк.
Один распространённый момент, вызывающий путаницу: Google AI Studio и Google Cloud Console — это два разных интерфейса к одной и той же базовой инфраструктуре. Ваш API key, созданный в AI Studio, также виден в Cloud Console в разделе APIs & Services → Credentials, и наоборот. AI Studio спроектирован как удобный интерфейс для разработчиков с упрощённым управлением, тогда как Cloud Console предоставляет доступ к более детальным настройкам — ограничениям API, управлению квотами и конфигурации биллинга. Во время настройки вам понадобятся оба интерфейса: AI Studio для создания ключа и Cloud Console для подключения биллинга и настройки ограничений.
Также стоит отметить, что API-ключи, созданные в AI Studio, автоматически привязаны к Generative Language API — это всё, что нужно для генерации изображений через Nano Banana Pro. Если вы создадите ключ через Cloud Console, может потребоваться вручную активировать Generative Language API для вашего проекта, прежде чем ключ заработает с моделями Gemini.
Подключение биллинга и система уровней
Именно здесь большинство разработчиков натыкаются на первую стену, и именно этот шаг почти каждое руководство либо пропускает, либо упоминает вскользь. Бесплатный уровень API в Google AI Studio позволяет выполнять текстовые вызовы API с моделями Gemini, но генерация изображений явно исключена из бесплатного уровня (официальная страница цен Google AI, февраль 2026). При попытке сгенерировать изображение без подключённого биллинга вы получите ошибку RESOURCE_EXHAUSTED — что сбивает с толку, потому что выглядит как проблема с лимитом запросов, хотя на самом деле это требование биллинга. Подробное руководство по решению этой конкретной ошибки вы найдёте в нашей статье об исправлении ошибки RESOURCE_EXHAUSTED.
Чтобы подключить биллинг, необходимо привязать платёжный аккаунт к проекту Google Cloud, связанному с вашим API key. Начните с перехода в Google Cloud Console и нажмите «Link a billing account». Вам потребуется указать действительный способ оплаты (кредитная карта, дебетовая карта или, в некоторых регионах, банковский счёт). Google не взимает плату авансом — вы платите только за фактически выполненные вызовы API. После подключения биллинга ваш проект автоматически переходит на Tier 1, что разблокирует возможности генерации изображений.
Система уровней API Google определяет ваши лимиты запросов и доступные функции, и её понимание избавит вас от неожиданных ограничений. Уровень Free предоставляет базовый текстовый доступ к API, но генерация изображений полностью отсутствует. Tier 1 активируется сразу после подключения биллинга (без минимальных затрат) и разблокирует генерацию изображений со стандартными лимитами. Tier 2 требует совокупных расходов от $250 и более за не менее 30 дней и предоставляет повышенные лимиты запросов. Tier 3 требует совокупных расходов от $1 000 и более за не менее 30 дней и обеспечивает максимальные доступные лимиты запросов (все данные по уровням из ai.google.dev/rate-limits, февраль 2026). Для генерации изображений, в частности, лимиты на Tier 1 обычно позволяют 5-10 изображений в минуту для стандартных пользователей, чего достаточно для разработки и умеренных рабочих нагрузок.
Настоятельно рекомендуется установить оповещение о бюджете для предотвращения неожиданных списаний. В Google Cloud Console перейдите в раздел Billing → Budgets & Alerts и создайте бюджет для своего проекта. Вы можете настроить оповещения при достижении 50%, 90% и 100% от выбранной суммы — начать с $10-20 вполне разумно для разработки. Бюджетные оповещения отправляют уведомления по электронной почте, но не останавливают автоматически использование API, поэтому если вам нужны жёсткие лимиты расходов, потребуется реализовать ограничение частоты запросов в коде вашего приложения.
Распространённый вопрос разработчиков — нужна ли кредитная карта Google Cloud только для тестирования. Ответ — да: для биллинга требуется действительный способ оплаты, даже если вы планируете потратить всего несколько центов в процессе разработки. Однако Google часто предлагает бесплатные пробные кредиты ($300 для новых аккаунтов Google Cloud), которые могут покрыть ваши первоначальные расходы на API. Проверьте наличие доступных кредитов в Google Cloud Console перед началом работы, так как они могут покрыть значительный объём тестирования и прототипирования.
Генерация первого изображения: Python, Node.js и REST API
После создания API key и подключения биллинга вы готовы к генерации первого изображения. Ниже представлены полные, готовые к запуску примеры кода на трёх языках, которые можно скопировать прямо в ваш проект. Каждый пример генерирует изображение из текстового промпта с использованием модели gemini-3-pro-image-preview.
Python (google-genai SDK)
Python SDK — самый популярный способ взаимодействия с Nano Banana Pro API. Сначала установите его, затем настройте переменную окружения и запустите код генерации:
bashpip install google-genai export GEMINI_API_KEY="your-api-key-here"
pythonfrom google import genai from google.genai import types import base64 import os client = genai.Client(api_key=os.environ["GEMINI_API_KEY"]) response = client.models.generate_content( model="gemini-3-pro-image-preview", contents="Generate a photorealistic image of a futuristic city skyline at sunset, with flying vehicles and neon lights reflecting off glass towers.", config=types.GenerateContentConfig( response_modalities=["TEXT", "IMAGE"], ), ) for part in response.candidates[0].content.parts: if part.inline_data is not None: image_data = base64.b64decode(part.inline_data.data) with open("generated_image.png", "wb") as f: f.write(image_data) print(f"Image saved! MIME type: {part.inline_data.mime_type}") elif part.text is not None: print(f"Model response: {part.text}")
Node.js (@google/genai SDK)
Для разработчиков на JavaScript и TypeScript Google предоставляет пакет @google/genai. Это официально поддерживаемый SDK, функциональность которого точно повторяет Python SDK:
bashnpm install @google/genai export GEMINI_API_KEY="your-api-key-here"
javascriptimport { GoogleGenAI } from "@google/genai"; import fs from "fs"; const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY }); async function generateImage() { const response = await ai.models.generateContent({ model: "gemini-3-pro-image-preview", contents: "Generate a photorealistic image of a futuristic city skyline at sunset, with flying vehicles and neon lights reflecting off glass towers.", config: { responseModalities: ["TEXT", "IMAGE"], }, }); for (const part of response.candidates[0].content.parts) { if (part.inlineData) { const imageBuffer = Buffer.from(part.inlineData.data, "base64"); fs.writeFileSync("generated_image.png", imageBuffer); console.log(`Image saved! MIME type: ${part.inlineData.mimeType}`); } else if (part.text) { console.log(`Model response: ${part.text}`); } } } generateImage();
REST API (cURL)
Если вы предпочитаете работать напрямую с HTTP API — что полезно для тестирования, отладки или интеграции из языков без официального SDK — можно использовать cURL или любой HTTP-клиент:
bashcurl -X POST \ "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key=${GEMINI_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "contents": [{ "parts": [{ "text": "Generate a photorealistic image of a futuristic city skyline at sunset." }] }], "generationConfig": { "responseModalities": ["TEXT", "IMAGE"] } }'
Ответ будет содержать base64-закодированное изображение в массиве candidates[0].content.parts. Ищите части с полем inlineData — это и есть сгенерированное изображение. Критически важный момент, который упускают многие руководства: вы обязательно должны включить "responseModalities": ["TEXT", "IMAGE"] в конфигурацию. Без этого модель вернёт только текст, даже если вы попросили сгенерировать изображение. Также учтите, что некоторые промпты могут активировать фильтры безопасности контента, что приведёт к пустому ответу без сообщения об ошибке. Стратегии работы в рамках политик контента описаны в нашем руководстве по предотвращению нарушений контентной политики.
При составлении промптов для Nano Banana Pro конкретность радикально улучшает результаты. Вместо «кот» попробуйте «фотореалистичный полосатый кот, сидящий на солнечном подоконнике, с мягким боке на заднем плане, снято на объектив 50 мм». Модель хорошо реагирует на фотографическую терминологию (диафрагма, тип объектива, направление освещения), отсылки к художественным стилям (акварель, масляная живопись, цифровое искусство) и инструкции по композиции (правило третей, центрированное, вид сверху). Для продакшн-приложений стоит рассмотреть создание системы шаблонов промптов, которая подставляет стабильные параметры стиля, позволяя пользовательскому промпту фокусироваться на содержании.
Ещё одно практическое соображение — время ответа. Стандартная генерация изображений через API обычно завершается за 5-15 секунд в зависимости от сложности и текущей нагрузки на серверы. Если у вашего приложения строгие требования к задержке, рассмотрите асинхронную генерацию изображений и кэширование результатов. Batch API, хотя и дешевле, доставляет результаты в течение 24 часов, а не секунд, поэтому не подходит для приложений реального времени, ориентированных на пользователей.
Лучшие практики безопасности API Key
Обеспечение безопасности API key не является необязательным — утечка ключа может привести к несанкционированному использованию, увеличивающему ваш счёт, а Google возлагает на вас ответственность за все расходы, понесённые с использованием вашего ключа, независимо от того, кто выполнял запросы. В этом разделе рассматриваются основные меры безопасности, которые ни одно другое руководство по Nano Banana Pro в настоящее время не включает.
Переменные окружения — это минимальный стандарт. Никогда не вписывайте API key напрямую в исходный код. Вместо этого храните его в переменной окружения и считывайте при запуске. Создайте файл .env в корне проекта (и немедленно добавьте .env в .gitignore):
bash# .env file - NEVER commit this to version control GEMINI_API_KEY=AIzaSyD_your_key_here
В Python используйте пакет python-dotenv для автоматической загрузки: from dotenv import load_dotenv; load_dotenv(). В Node.js используйте пакет dotenv: import 'dotenv/config'. Для продакшн-развёртываний используйте менеджеры секретов вашей платформы (AWS Secrets Manager, Google Cloud Secret Manager, Vercel Environment Variables или аналогичные).
Ограничьте область действия API key. В Google Cloud Console в разделе APIs & Services → Credentials вы можете ограничить каждый API key по IP-адресу, HTTP-реферреру или API-сервису. Для разработки ключ можно оставить без ограничений, но для продакшна следует ограничить его только теми API, которые вы фактически используете (в данном случае — Generative Language API), и IP-адресами вашего сервера. Таким образом, даже при утечке ключа его нельзя будет использовать с неавторизованных локаций или для неавторизованных API.
Периодически ротируйте ключи. Создайте новый API key, обновите приложение для использования нового ключа, убедитесь, что всё работает, а затем удалите старый ключ. Это ограничивает окно уязвимости, если ключ был скомпрометирован без вашего ведома. Google упрощает этот процесс через AI Studio — у вас может быть несколько активных ключей для одного проекта, что позволяет выполнять ротацию без простоя.
Настройте бюджетные оповещения и квоты. Как упоминалось в разделе о биллинге, бюджетные оповещения в Google Cloud Console уведомляют вас при приближении расходов к пороговым значениям. Кроме того, вы можете настроить квоты на уровне проекта в разделе IAM & Admin для установки жёстких лимитов использования API. Это создаёт страховочную сеть: даже если ваш ключ будет скомпрометирован, использование злоумышленником будет ограничено вашими настройками квот. Разумная начальная конфигурация — ежемесячный бюджет $20-50 для разработки с оповещениями при достижении 50% и 90%.
Активно отслеживайте использование API key. Google Cloud Console предоставляет детальные метрики использования в разделе APIs & Services → Dashboard. Вы можете видеть, сколько именно запросов выполняет каждый API key, когда происходят всплески использования и какие эндпоинты вызываются. Если вы заметите необычные паттерны — например, всплеск запросов в 3 часа ночи, когда ваше приложение должно бездействовать, — это ранний индикатор компрометации. Настройка оповещений Cloud Monitoring для аномальных паттернов трафика добавляет ещё один уровень защиты помимо простых бюджетных оповещений. Для продакшн-приложений, обрабатывающих конфиденциальные данные, рассмотрите реализацию прокси-слоя между клиентскими приложениями и API, чтобы настоящий API key никогда не покидал вашу серверную инфраструктуру.
Разбор цен и оптимизация затрат
Понимание структуры ценообразования помогает выбрать правильную модель и режим API для вашего случая использования. Все ценовые данные ниже верифицированы по официальной документации Google по состоянию на февраль 2026 года.
Nano Banana Pro тарифицируется на основе использования токенов, причём выходные токены значительно дороже входных, поскольку генерация изображений происходит на этапе вывода. Конкретно, стоимость ввода составляет $2,00 за миллион токенов, а стоимость вывода — $120,00 за миллион токенов (ai.google.dev/pricing, февраль 2026). Поскольку типичная генерация изображения использует приблизительно 1 120 выходных токенов, стоимость за изображение составляет примерно $0,134 для стандартного разрешения (1K или 2K). При генерации в разрешении 4K (4096x4096) количество выходных токенов увеличивается, что доводит стоимость за изображение приблизительно до $0,24.
Модель Nano Banana (вариант Flash, gemini-2.5-flash-image) кардинально дешевле: $0,30 за миллион входных токенов и $30,00 за миллион выходных токенов, что даёт стоимость за изображение приблизительно $0,039 — примерно в 3,4 раза дешевле Pro. Компромисс — более низкое разрешение, отсутствие поддержки 4K и режима Thinking. Для многих задач, таких как генерация миниатюр, постов в социальных сетях или быстрое прототипирование, Flash предлагает отличное соотношение цена/качество.
Batch API — самый мощный инструмент оптимизации затрат от Google, предлагающий фиксированную скидку 50% на все модели с компромиссом в виде асинхронной обработки (результаты доставляются в течение 24 часов вместо реального времени). С Batch API стоимость за изображение для Nano Banana Pro снижается приблизительно до $0,067, а для Nano Banana (Flash) — приблизительно до $0,020 за изображение. Если ваше приложение допускает задержку результатов — например, пакетная обработка каталога товарных изображений за ночь — Batch API должен быть вашим выбором по умолчанию.
| Модель | Стандарт (за изображение) | Пакетный (за изображение) | Лучше всего для |
|---|---|---|---|
| Nano Banana Pro (1K/2K) | ~$0,134 | ~$0,067 | Высокое качество, 4K, режим Thinking |
| Nano Banana Pro (4K) | ~$0,240 | ~$0,120 | Максимальное разрешение |
| Nano Banana (Flash) | ~$0,039 | ~$0,020 | Экономичность, прототипирование |
Чтобы представить эти затраты в практическом контексте, рассмотрим несколько типичных сценариев. SaaS-приложение, генерирующее 100 товарных изображений в день, будет стоить приблизительно $402 в месяц при использовании Pro Standard, $201 при использовании Pro Batch, $117 при использовании Flash Standard или всего $60 при использовании Flash Batch. Для персонального блога, генерирующего 5 обложек в неделю, ежемесячная стоимость составит менее $3 независимо от выбранной модели и режима. Скидка 50% Batch API делает его очевидным выбором для любой рабочей нагрузки, не требующей реального времени, и он должен быть вашим выбором по умолчанию, если вам не нужно время отклика менее минуты.
Для разработчиков в регионах с ограниченным прямым доступом к Google API или для тех, кому нужен консолидированный биллинг по нескольким моделям ИИ, сторонние поставщики API, такие как laozhang.ai, предлагают доступ к Nano Banana Pro по тарифам обычно ниже 50% от официальных цен — приблизительно $0,05 за изображение — без ограничения частоты запросов и с упрощённой интеграцией. Это особенно полезно для команд, использующих несколько ИИ-сервисов (генерация изображений, текстовые модели, эмбеддинги) и желающих консолидировать управление API и биллинг в рамках одного провайдера. Подробное сравнение Nano Banana Pro с конкурирующими моделями вы найдёте в нашем сравнении Nano Banana Pro и Flux2.
Распространённые ошибки и быстрые решения
При работе с Nano Banana Pro API вы, скорее всего, столкнётесь хотя бы с одной из этих пяти ошибок во время настройки. Понимание значения каждой ошибки и способов её устранения экономит часы отладки.
API_KEY_INVALID (HTTP 400) — самая прямолинейная ошибка: ваш API key имеет неправильный формат, был удалён или ещё не активирован. Наиболее частая причина — случайное копирование лишних пробелов или переносов строк при копировании ключа из AI Studio. Для исправления перегенерируйте ключ на aistudio.google.com/apikey и аккуратно скопируйте всю строку без начальных или конечных пробелов. Проверить работоспособность ключа можно с помощью простого cURL-теста, описанного в разделе настройки выше.
RESOURCE_EXHAUSTED (HTTP 429) — самая запутанная ошибка для новых пользователей, потому что она выглядит как проблема с лимитом запросов, но на самом деле почти всегда связана с биллингом. Если вы на бесплатном уровне и пытаетесь сгенерировать изображение, вы получите эту ошибку, потому что генерация изображений недоступна на бесплатном уровне. Решение простое: подключите биллинг к проекту Google Cloud (см. раздел «Биллинг» выше). Если биллинг подключён и вы всё равно видите эту ошибку, значит, это действительно проблема с лимитом запросов — вы выполняете слишком много запросов в минуту. Реализуйте экспоненциальную задержку (exponential backoff) в коде или подождите минуту перед повторной попыткой. Подробное устранение этой конкретной ошибки описано в нашем полном справочнике по кодам ошибок и пошаговом руководстве по отладке, которые рассматривают все возможные причины и решения.
PERMISSION_DENIED (HTTP 403) означает, что ваш API key существует, но не имеет необходимых разрешений. Распространённые причины: Generative Language API не активирован для вашего проекта, ключ имеет ограничения по IP или реферреру, блокирующие вашу текущую локацию, или ключ принадлежит проекту в регионе, где Gemini API недоступен. Исправление: проверьте ограничения API key в Cloud Console (APIs & Services → Credentials) и убедитесь, что Generative Language API активирован для вашего проекта.
RATE_LIMIT_EXCEEDED (HTTP 429) — это ошибка реального ограничения частоты запросов: вы отправляете слишком много запросов в рамках допустимого временного окна. На бесплатном уровне лимиты составляют приблизительно 5-10 запросов в минуту. На Tier 1 (биллинг подключён) лимиты возрастают приблизительно до 100-300 запросов в минуту (верифицированные данные из статьи, февраль 2026). Лучшее решение — реализация экспоненциальной задержки с джиттером (случайным разбросом) в коде или использование Batch API для массовых операций, который имеет отдельные, более щедрые квоты. Для комплексного устранения всех типов ошибок посетите наш всеобъемлющий центр устранения неполадок.
SAFETY / IMAGE_BLOCKED (HTTP 200 с пустым изображением) — самая коварная ошибка, потому что API возвращает код статуса 200 (успех), но без данных изображения в ответе. Это происходит, когда ваш промпт активирует фильтры безопасности контента Google. Тело ответа будет содержать finishReason со значением SAFETY вместо STOP. Для исправления перефразируйте промпт, избегая генерации реальных человеческих лиц, логотипов брендов, персонажей, защищённых авторским правом, или контента, который может считаться неприемлемым. Всегда проверяйте response.candidates[0].content.parts на наличие inlineData перед попыткой декодирования изображения.
Надёжный паттерн обработки ошибок, охватывающий все пять сценариев, необходим для продакшн-приложений. Ключевые принципы: всегда сначала проверяйте HTTP-код статуса, различайте ошибки 429, связанные с биллингом, и реальные ограничения частоты запросов через проверку статуса биллинга, реализуйте экспоненциальную задержку со случайным фактором джиттера для ошибок ограничения частоты и никогда не предполагайте, что ответ 200 содержит изображение — всегда проверяйте наличие inlineData в частях ответа. Встраивание этих проверок в обёртку API с самого начала экономит значительное время отладки в дальнейшем, особенно при масштабировании с разработки до продакшн-нагрузок.
Часто задаваемые вопросы
Бесплатен ли Nano Banana Pro API? Создание API key бесплатно, и вы можете выполнять текстовые вызовы API на бесплатном уровне. Однако генерация изображений требует платного уровня (Tier 1 или выше), то есть вам необходимо подключить биллинг к проекту Google Cloud. Бесплатной квоты на генерацию изображений через API нет. Если вы хотите попробовать генерацию изображений без затрат на API, веб-интерфейс Google AI Studio (не API) может предлагать ограниченную бесплатную генерацию через потребительскую подписку AI Pro ($19,99/мес.), но это отдельно от доступа через API.
В чём разница между Nano Banana и Nano Banana Pro? Nano Banana (Flash) использует model ID gemini-2.5-flash-image и стоит приблизительно $0,039 за изображение — примерно в 3,4 раза дешевле Pro. Однако он не поддерживает разрешение 4K, режим Thinking и поисковое обоснование. Nano Banana Pro (gemini-3-pro-image-preview) предлагает наивысшее качество вывода, разрешение 4K и продвинутые функции, такие как генерация с управлением через рассуждение. Выбирайте Flash для приложений, чувствительных к стоимости или с большими объёмами, и Pro — когда качество изображений является главным приоритетом.
Как долго хранятся сгенерированные изображения? Изображения, возвращённые API в виде base64-закодированных данных в теле ответа, являются постоянными — после декодирования и сохранения они существуют в вашем хранилище бессрочно. Однако если вы используете URL, предоставленные API для предварительного просмотра, эти URL являются временными и могут истечь в течение нескольких часов. Всегда сохраняйте данные в формате base64 сразу после получения ответа, не полагаясь на URL предварительного просмотра. Подробнее об этом поведении читайте в нашей статье о проблеме истечения срока временных изображений.
Можно ли использовать один API key для нескольких приложений? Да, один API key можно использовать в нескольких приложениях. Однако для продакшн-развёртываний это не рекомендуется. Если ключ одного приложения будет скомпрометирован, это затронет все приложения, использующие этот ключ. Лучшая практика — создавать отдельные API-ключи для каждого приложения или среды (разработка, staging, продакшн) в рамках одного проекта Google Cloud и использовать отдельные проекты для действительно независимых приложений.
Каковы лимиты запросов для Nano Banana Pro? Лимиты запросов зависят от вашего уровня API. На бесплатном уровне вы получаете приблизительно 5-10 запросов в минуту (RPM) и 50-100 запросов в день (RPD) для текста, но генерация изображений недоступна. На Tier 1 (биллинг подключён) лимиты возрастают приблизительно до 100-300 RPM с максимумом до 10 000 RPD. Генерация изображений имеет собственное измерение лимитов — IPM (Images Per Minute). Batch API имеет отдельные квоты, измеряемые в токенах очереди, при этом Tier 1 допускает 2 миллиона токенов очереди batch для Nano Banana Pro (ai.google.dev/rate-limits, февраль 2026).
Сколько стоит генерация 1000 изображений? С Nano Banana Pro в стандартном разрешении 1000 изображений стоят приблизительно $134 через стандартный API или около $67 через Batch API (скидка 50%). С Nano Banana (Flash) те же 1000 изображений стоят приблизительно $39 стандартно или $20 через Batch. Для минимально возможной стоимости комбинация Flash + Batch API доводит цену за изображение до приблизительно $0,020 — то есть 1000 изображений всего за $20.
Нужен ли аккаунт Google Cloud или достаточно обычного аккаунта Google? Вам нужен стандартный аккаунт Google (Gmail) для доступа к Google AI Studio и создания API key. Однако при создании первого API key AI Studio автоматически создаёт проект Google Cloud за кулисами. Вам не нужно вручную настраивать аккаунт Google Cloud или работать с Cloud Console для базового создания API key. Обращаться к Cloud Console напрямую нужно только при подключении биллинга, настройке ограничений API или установке бюджетных оповещений. Переход от простого аккаунта Google к проекту с поддержкой Google Cloud происходит бесшовно и обрабатывается автоматически AI Studio.
Можно ли использовать Nano Banana Pro через Vertex AI вместо AI Studio? Да, обе платформы предоставляют доступ к одним и тем же моделям Gemini, но механизм аутентификации отличается. В AI Studio вы используете API key (подход, описанный в этом руководстве). В Vertex AI вы используете учётные данные сервисного аккаунта Google Cloud и токены OAuth 2.0, что обеспечивает более детальный контроль доступа, подходящий для корпоративных развёртываний. Ценообразование идентично независимо от того, какую платформу вы используете для доступа к API. Для большинства индивидуальных разработчиков и небольших команд AI Studio с API-ключами — самый быстрый и простой путь. Vertex AI становится лучшим выбором, когда вам нужен контроль доступа на уровне IAM, VPC Service Controls или соответствие конкретным корпоративным требованиям безопасности.