# Nano Banana API Key Guide 2026: официальный Gemini key, модели, цены и рабочий код > Nano Banana API key на практике является Gemini API key, управляемым через Google AI Studio. Получите key там, но не смешивайте credential, billing, project limits, free-tier claims и third-party gateway keys. - URL: https://blog.laozhang.ai/ru/posts/nano-banana-ai-image-generation-api - Published: 2026-03-29 - Updated: 2026-07-01 - Author: AI Free API Team (https://blog.laozhang.ai/ru/about) - Category: API Guide - Tags: Nano Banana API, Gemini API, Генерация изображений, Google AI, Nano Banana 2, Nano Banana Pro --- Если вам нужен **официальный Nano Banana API key**, правильная точка входа — **Gemini API key в Google AI Studio**. Этот key аутентифицирует запросы Gemini API; это не отдельный аккаунт Nano Banana, не обещание бесплатного image output и не key, выданный third-party gateway. Текущая страница Google по Nano Banana image generation помечает **Interactions API** как generally available и рекомендует его для последних моделей и функций; на той же странице все еще есть generateContent version. Какой бы request shape вы ни выбрали, key, billing, project limits и model-choice rules остаются теми же. На **1 июля 2026 года** семейство Nano Banana в Gemini API включает `gemini-3.1-flash-lite-image`, `gemini-3.1-flash-image`, `gemini-3-pro-image` и legacy `gemini-2.5-flash-image`. Все model ID, цены, key behavior и project limits ниже были повторно проверены по актуальным Google developer docs и pricing tables на **1 июля 2026 года**. ![Официальная схема маршрута Nano Banana API с акцентом на Gemini API и AI Studio](https://blog.laozhang.ai/posts/ru/nano-banana-ai-image-generation-api/img/cover.png) Перед выбором сервиса для приложения сравните [стоимость Nano Banana API, получение изображений и восстановление после ошибок у Google и LaoZhang](https://blog.laozhang.ai/ru/posts/cheap-stable-nano-banana-api). ## Короткий ответ Вот самый короткий правильный маршрут. | Если ваша реальная задача такая | Начните отсюда | Почему это лучший путь | Главное ограничение | | --- | --- | --- | --- | | Вам нужен официальный Google image API | **Gemini API + Nano Banana 2** | Это нынешний высокоэффективный дефолт Google для image generation и editing | Текущие image routes — платные | | Вам нужны более качественные финальные assets, лучший text rendering или более сложное visual reasoning | **Nano Banana Pro** | Это премиальный профессиональный tier | Стоит дороже и должен быть override, а не дефолтом | | Вы хотите сначала тестировать prompts в официальном интерфейсе Google | **AI Studio** | Та же официальная технология, но удобнее для проверки до кода | Google прямо пишет, что для Nano Banana 2 там нужен paid API key | | Вы просто создаете изображения как пользователь | **Gemini Apps или AI Mode** | Это удобно для повседневного использования без кода | Это отдельный потребительский контракт, а не API-контракт | | Вам нужен OpenAI-compatible routing или единый биллинг между поставщиками | **Опциональный gateway / wrapper** | Как инфраструктурный слой это может быть полезно | Но это второй шаг после понимания официального пути | Практическое правило такое: **воспринимайте "Nano Banana API" как вопрос про Gemini API, а не как поиск одного "настоящего" сайта Nano Banana**. ## Что сейчас означает Nano Banana API Текущая image-generation documentation Google определяет **Nano Banana** как нативную возможность Gemini по генерации изображений, а не как один surface. На API-практике это означает небольшое семейство моделей: | Название семейства | Официальный model ID | Текущая роль | | --- | --- | --- | | Nano Banana 2 Lite | `gemini-3.1-flash-lite-image` | Lite-route для 1K output, когда важнее всего latency и cost | | Nano Banana 2 | `gemini-3.1-flash-image` | Дефолтный API-старт с балансом quality, 4K, text rendering, editing и throughput | | Nano Banana Pro | `gemini-3-pro-image` | Премиальный tier для более высокого качества и сильного text rendering | | Nano Banana | `gemini-2.5-flash-image` | Более старая low-latency route | Многие результаты поиска до сих пор не объясняют это достаточно ясно. По самому запросу кажется, будто должен существовать один "Nano Banana API", одна страница продукта, один account flow и одна очевидная модель. Google сейчас описывает это иначе. Корректная структура — это **выбор внутри семейства плюс выбор surface**: - какая версия семейства вам нужна - нужен ли вам официальный API, официальный testing UI или consumer surface Второе важное уточнение: **генерация изображений уже является частью Gemini request/response contract**, а не каким-то отдельным image-only black box за пределами обычного API. Текущие docs уже показывают форму запроса, image editing, управление aspect ratio, image size и search grounding. Google также прямо пишет, что **все сгенерированные изображения включают SynthID watermark**. Для команд, которые думают о provenance, disclosure или AI labeling, это важнее, чем кажется. Если ваш вопрос шире и вам нужен не API, а обзор пользовательских входов через Gemini, AI Mode и другие surfaces Google, смотрите наш [большой гид по Nano Banana AI image generator](https://blog.laozhang.ai/ru/posts/nano-banana-ai-image-generator). Эта статья уже про другое: она отвечает именно на вопрос **как правильно зайти через официальный API**. ## Какой путь является официальным API, а какой нет Самый быстрый способ запутаться — сложить **Gemini Apps, AI Mode, AI Studio, Gemini API и wrappers** в одну корзину. Они связаны, но это не один и тот же контракт. ![Схема трех контрактов доступа: consumer surfaces, официальный API и опциональные gateways](https://blog.laozhang.ai/posts/ru/nano-banana-ai-image-generation-api/img/route-boundary-map.png) **Gemini API** — это официальный программный путь. Если вашему приложению нужно использовать Interactions API или generateContent, отправлять prompt или входные изображения, получать image output и управлять такими параметрами, как aspect ratio и image size, то ответ именно здесь. **Google AI Studio** — официальный интерфейс для тестирования и разработки поверх того же стека. Он особенно полезен, когда вы хотите быстро проверять prompts и видеть поведение модели до того, как завернете это в код. Официальный rollout post Google от 26 февраля 2026 года про Nano Banana 2 важен тем, что делает явным один момент, который легко упустить: **для использования Nano Banana 2 в Google AI Studio требуется paid API key**. То есть AI Studio — это официальный UI поверх developer stack, а не скрытый бесплатный обход текущего pricing для image routes. **Gemini Apps** и **AI Mode** — реальные продуктовые входы, но они относятся к потребительскому сценарию, а не являются ответом на API-вопрос. Gemini Apps Help сейчас разделяет роли Nano Banana и Nano Banana Pro в повседневной работе и advanced output, а AI Mode Help отдельно описывает image limits и специальную роль Pro для infographics и diagrams. Это важно, если вы выбираете путь как пользователь. Но это **не меняет API-контракт**. **Wrappers и gateways** — отдельный инфраструктурный слой. Они могут быть полезны, если вам действительно нужны OpenAI-compatible requests, multi-vendor routing или другой биллинг. Но это второй вопрос, а не первый. Если страница начинает с того, что подменяет собой сам продукт, то у вас уже неправильная отправная точка. Простое правило маршрутизации такое: - нужен код — идите в **Gemini API** - нужна официальная prompt-проверка — идите в **AI Studio** - вы решаете не API-задачу, а consumer-задачу — используйте **Gemini Apps** или **AI Mode** - **gateway** нужен только после того, как вы поняли официальный путь ## Начинайте с Nano Banana 2; Lite и Pro выбирайте только по причине Это самый полезный judgment, который можно снять с читателя заранее: Nano Banana 2 остается безопасным default, Lite нужен только для 1K cost/latency jobs, а Pro — только когда качество действительно стало blocker. Текущие Google image-generation docs описывают **Nano Banana 2** как высокоэффективный counterpart к Pro, оптимизированный под скорость и high-volume developer use cases. Более того, официальный Google rollout post февраля 2026 года вообще называет Nano Banana 2 **"our best image generation and editing model."** Для API-guide это означает одну простую вещь: не стоит исходить из того, что Pro — дефолт только потому, что звучит более премиально. ![Decision board с разделением Nano Banana 2 Lite, Nano Banana 2 и Nano Banana Pro по model choice, official pricing, Free Tier boundary и verified date](https://blog.laozhang.ai/posts/ru/nano-banana-ai-image-generation-api/img/model-price-chooser.png) Начинайте с **Nano Banana 2**, если: - вы делаете первую интеграцию - вам важны скорость итерации и price efficiency - вы ожидаете ощутимый объем - вам нужен безопасный дефолт для general image generation и editing - у вас пока нет четкой Pro-причины Переходите на **Nano Banana Pro**, если: - качество text rendering критично для результата - изображение — это финальный asset, а не рабочий черновик - вам нужно более сильное reasoning по сложным visual instructions - задача зависит от diagram-heavy, layout-sensitive или brand-critical output И **Nano Banana** (`gemini-2.5-flash-image`) тоже не исчезает: - если у вас уже есть workload, заточенный под эту старую fast route - если вы действительно хотите low latency, а не поведение нового Nano Banana 2 Важная тонкость: это не просто "лестница качества". Это вопрос **соответствия workload**. Nano Banana 2 — не просто дешевая версия Pro. Google сейчас ставит его в центр как основной API default. Pro — это более дорогой override. Такое правило выбора гораздо полезнее, чем расплывчатое "если нужен лучший quality — берите Pro", которое до сих пор любят wrappers. Если после этого базового выбора вам нужен более глубокий workload-level разбор, читайте наш [подробный разбор Nano Banana Pro vs Nano Banana 2](https://blog.laozhang.ai/ru/posts/nano-banana-pro-vs-nano-banana-2). Здесь задача другая: помочь вам правильно стартовать. ## Quickstart: получите key, затем выберите Interactions API или generateContent Официальный путь короче, чем это выглядит по многим сторонним туториалам. ### 1. Получите Gemini API key Создайте ключ в **Google AI Studio**. Сама выдача ключа у Google устроена просто, но это нельзя путать с бесплатным контрактом на image output. Каждый Gemini API key связан с Google Cloud project; новые AI Studio keys создаются как auth keys, а dormant unrestricted keys могут быть blocked. Если честно читать текущий pricing для image routes, картина такая: - **получить key просто** - **использовать текущие image models — это paid API path** ### 2. Установите актуальный официальный SDK Текущая libraries page Google рекомендует **Google GenAI SDK**, а не старые legacy-клиенты Gemini. ```bash # JavaScript / TypeScript npm install @google/genai # Python pip install -U google-genai ``` Если вы видите старые примеры на `google-generativeai`, относитесь к ним как к историческим, а не как к лучшему текущему пути. ### 3. Отправьте минимальный image-generation request Для новой интеграции сначала смотрите официальный Interactions API path. Если вы поддерживаете generateContent request shape, пример ниже все еще полезен для проверки key, model ID, image bytes и save flow. Для новой интеграции сначала используйте Nano Banana 2: ```javascript import { GoogleGenAI } from "@google/genai"; import fs from "node:fs"; const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY }); const response = await ai.models.generateContent({ model: "gemini-3.1-flash-image", contents: "Create a clean editorial illustration of a robot sketching a website wireframe.", config: { responseModalities: ["Image"], responseFormat: { image: { aspectRatio: "16:9", imageSize: "2K", }, }, }, }); for (const part of response.candidates[0].content.parts) { if (part.inlineData) { fs.writeFileSync("output.png", Buffer.from(part.inlineData.data, "base64")); } } ``` Python-версия устроена так же: ```python import os from google import genai from google.genai import types client = genai.Client(api_key=os.environ["GEMINI_API_KEY"]) response = client.models.generate_content( model="gemini-3.1-flash-image", contents="Create a clean editorial illustration of a robot sketching a website wireframe.", config=types.GenerateContentConfig( response_modalities=["Image"], response_format={ "image": { "aspect_ratio": "16:9", "image_size": "2K", } }, ), ) for part in response.parts: if part.inline_data is not None: part.as_image().save("output.png") ``` Если вы хотите проверить чистую HTTP-форму, официальный REST request тоже предельно короткий: ```bash curl -X POST \ "https://generativelanguage.googleapis.com/v1/models/gemini-3.1-flash-image:generateContent" \ -H "x-goog-api-key: ${GEMINI_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "contents": [{ "parts": [ {"text": "Create a clean editorial illustration of a robot sketching a website wireframe."} ] }], "generationConfig": { "responseModalities": ["Image"], "responseFormat": { "image": { "aspectRatio": "16:9", "imageSize": "2K" } } } }' ``` Переход на Pro нарочно скучный: форма запроса остается той же, меняется только model ID на `gemini-3-pro-image`. Именно поэтому workflow "сначала Nano Banana 2, потом Pro при явной причине" настолько практичен: вам не нужно переписывать всю интеграцию только ради теста премиального tier. ![Схема первого официального запроса: от API key к client, generateContent и image output](https://blog.laozhang.ai/posts/ru/nano-banana-ai-image-generation-api/img/first-request-flow.png) ## Какие возможности уже есть в официальном API, прежде чем строить систему вокруг wrapper Официальный Gemini route стоит брать за baseline не только потому, что он "официальный", но и потому, что сам по себе уже богаче, чем это часто показывают gateway landing pages. **Image editing встроен из коробки.** Текущие image-generation docs показывают text-and-image-to-image workflows, а не только prompt-only generation. Это важно, если вашему продукту нужна именно редактура, а не разовая генерация. **Aspect ratio и image size управляются явно.** Официальный API поддерживает `responseFormat.image.aspectRatio`, а для текущих image models Google документирует sizes от `0.5K` до `4K`. Это значит, что вы можете сами управлять tradeoff между cost и latency, а не пускать все запросы по одному и тому же дефолту. **Search grounding уже встроен в официальный стек.** В image-generation docs `google_search` показан как официальный tool для image generation. Это особенно полезно для charts, weather visuals и grounded infographics. Но это не "бесплатная магия": pricing page рассматривает search grounding как отдельный billable layer после shared free allowance. **SynthID платформа уже обрабатывает сама.** Если вам важны provenance, disclosure и маркировка AI content, это важнее, чем любят признавать wrapper pages. Google прямо пишет, что все generated images include a SynthID watermark. Если знакомиться с Nano Banana сначала через wrapper, все эти преимущества легко недооценить. А именно они и определяют, достаточно ли вам официального стека без дополнительной абстракции. ## Цены и граница "бесплатно": именно здесь чаще всего все смешивают Большая часть плохих советов по Nano Banana API ломается именно на этом месте. Текущая **Gemini Developer API pricing page** показывает для этих image output routes статус **`Free Tier: Not available`**. По состоянию на **1 июля 2026 года** официальный прайс такой: | Модель | Standard pricing | Batch / Flex pricing | | --- | --- | --- | | Nano Banana 2 Lite (`gemini-3.1-flash-lite-image`) | `$0.0336 / 1K` | `$0.0168 / 1K` Batch | | Nano Banana 2 (`gemini-3.1-flash-image`) | `$0.045 / 0.5K`, `$0.067 / 1K`, `$0.101 / 2K`, `$0.151 / 4K` | `$0.022 / 0.5K`, `$0.034 / 1K`, `$0.050 / 2K`, `$0.076 / 4K` | | Nano Banana Pro (`gemini-3-pro-image`) | `$0.134 / 1K-2K`, `$0.24 / 4K` | `$0.067 / 1K-2K`, `$0.12 / 4K` | Как только вы держите в голове эту таблицу, многие страницы из выдачи начинают читаться иначе. Если какая-то страница намекает, что текущее image API Nano Banana "как бы free to start", но не раскладывает контракт, почти наверняка она смешивает: - бесплатную выдачу ключа - пробную риторику AI Studio - consumer quotas в Gemini или AI Mode - старые или вообще другие free-tier stories Это не один и тот же контракт. У потребительских входов есть собственные правила, которые зависят от аккаунта, региона, плана и функции. Эти лимиты помогают выбрать пользовательский интерфейс, но не доказывают API-биллинг, project quota или право на developer integration. Если ваш настоящий вопрос — "сколько стоит Nano Banana как API", то идите дальше в наш [гайд по ценам Nano Banana 2 API](https://blog.laozhang.ai/ru/posts/nano-banana-2-api-pricing-guide) и [разбор цен Gemini 3 Pro Image API](https://blog.laozhang.ai/ru/posts/gemini-3-pro-image-api-pricing). Здесь мы сначала решаем вопрос маршрута и подключения, а не полный cost model. ## Решение за 30 секунд Если вам нужно самое короткое дерево решений, держите его: **Если вы строите новую официальную интеграцию, используйте Gemini API + Nano Banana 2.** **Если задача действительно требует более сильного text rendering, visual fidelity или quality на уровне профессионального asset, переходите на Nano Banana Pro.** **Если сначала нужно просто проверить prompts в официальном интерфейсе Google, используйте AI Studio.** **Если ваша реальная задача — потребительский сценарий, а не API-интеграция, идите в Gemini Apps или AI Mode.** **Если вам нужен wrapper, сначала назовите инфраструктурную причину — например, OpenAI-совместимую маршрутизацию или единый multi-vendor billing. Не позволяйте wrapper определять сам продукт.** Это и есть самый чистый и практический ответ на текущий запрос. ## Частые вопросы **Что такое официальный Nano Banana API?** Это нативное image-семейство Gemini, доступное через Gemini API и Google AI Studio, а не отдельный самостоятельный developer product Nano Banana. **С какой модели мне начинать?** Начинайте с `gemini-3.1-flash-image`. Опускайтесь к `gemini-3.1-flash-lite-image` только для cost-sensitive 1K output, где ограничения Lite приемлемы. Переходите на `gemini-3-pro-image`, когда blocker — text rendering, complex layout reasoning, 4K или professional asset quality. **Какой официальный model ID у Nano Banana Pro?** `gemini-3-pro-image`. **Nano Banana API бесплатный?** Согласно текущей pricing page, сами image models не имеют free tier для image output. Consumer quotas и AI Mode usage — это отдельные контракты. **Что выбрать: AI Studio или Gemini API?** Лучше использовать оба: AI Studio для создания key и проверки prompt-поведения, Gemini API — для продовой интеграции в приложение. Для нового кода сначала смотрите Interactions API; для поддержки старых примеров и интеграций все еще полезно понимать generateContent. **AI Mode — это часть API?** Нет. AI Mode — это consumer Search surface со своими image limits и product behavior. **Поддерживает ли API image editing, а не только text-to-image?** Да. В Google image-generation docs уже есть официальные image-to-image workflows. **Есть ли watermark на generated images?** Да. Google документирует, что generated images include a SynthID watermark. **Что делать, если мне все же нужен gateway?** На практике официальный Gemini API уже покрывает самые ценные control-пункты для большинства команд: model selection, image editing, aspect ratio, image size и search grounding. Если этого все же недостаточно, gateway должен быть осознанным инфраструктурным выбором, а не стартовой точкой по умолчанию.