Nano Banana AI API генерации изображений в 2026 году: официальный путь Gemini, выбор модели и рабочий код

Если вам нужен официальный Nano Banana API сегодня, вы на самом деле ищете не отдельный продукт Nano Banana для разработчиков, а нативные image-модели Gemini в Gemini API или Google AI Studio. Для большинства API-сценариев самым безопасным стартом будет Nano Banana 2 с текущим model ID gemini-3.1-flash-image-preview. Переходить на Nano Banana Pro (gemini-3-pro-image-preview) стоит только тогда, когда задача действительно оправдывает премиальный tier: более сильный text rendering, более сложное следование инструкциям или качество, близкое к профессиональному production asset.

Этот прямой ответ важен потому, что по данному запросу сейчас слишком много ложных сокращений. Одни страницы подают Nano Banana как отдельное приложение, другие выдают AI Mode за API, третьи описывают wrapper/gateway так, будто это и есть определение продукта. Это не так. Правильная картина проще: Nano Banana — это нативное image-семейство Gemini; официальный developer path — Gemini API плюс AI Studio; а первой моделью для большинства команд должен быть Nano Banana 2.

Все model ID, цены и consumer limits ниже были повторно проверены по актуальным Google docs, help pages и pricing tables на 29 марта 2026 года.

Короткий ответ

Вот самый короткий правильный маршрут.

Практическое правило такое: воспринимайте "Nano Banana API" как вопрос про Gemini API, а не как поиск одного "настоящего" сайта Nano Banana.

Что сейчас означает Nano Banana API

Текущая image-generation documentation Google определяет Nano Banana как нативную возможность Gemini по генерации изображений, а не как один surface. На API-практике это означает небольшое семейство моделей:

Многие результаты поиска до сих пор не объясняют это достаточно ясно. По самому запросу кажется, будто должен существовать один "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. Эта статья уже про другое: она отвечает именно на вопрос как правильно зайти через официальный API.

Какой путь является официальным API, а какой нет

Самый быстрый способ запутаться — сложить Gemini Apps, AI Mode, AI Studio, Gemini API и wrappers в одну корзину. Они связаны, но это не один и тот же контракт.

Gemini API — это официальный программный путь. Если вашему приложению нужно вызывать generateContent, отправлять prompt или входные изображения, получать inline 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 для preview 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, если только не можете точно назвать причину для Pro

Это самый полезный judgment, который можно снять с читателя заранее.

Текущие 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 — дефолт только потому, что звучит более премиально.

Начинайте с 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. Здесь задача другая: помочь вам правильно стартовать.

Quickstart: как запустить первый запрос

Официальный путь короче, чем это выглядит по многим сторонним туториалам.

1. Получите Gemini API key

Создайте ключ в Google AI Studio. Сама выдача ключа у Google устроена просто, но это нельзя путать с бесплатным контрактом на image output. Если честно читать текущий pricing для preview image routes, картина такая:

• получить key просто
• использовать текущие preview image models — это paid API path

2. Установите актуальный официальный SDK

Текущая libraries page Google рекомендует Google GenAI SDK, а не старые legacy-клиенты Gemini.

bash

npm install @google/genai

# Python
pip install -U google-genai

Если вы видите старые примеры на google-generativeai, относитесь к ним как к историческим, а не как к лучшему текущему пути.

3. Отправьте минимальный image-generation request

Для новой интеграции сначала используйте 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-preview",
  contents: "Create a clean editorial illustration of a robot sketching a website wireframe.",
  config: {
    responseModalities: ["IMAGE"],
    imageConfig: {
      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-preview",
    contents="Create a clean editorial illustration of a robot sketching a website wireframe.",
    config=types.GenerateContentConfig(
        response_modalities=["IMAGE"],
        image_config=types.ImageConfig(
            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/v1beta/models/gemini-3.1-flash-image-preview: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"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

Переход на Pro нарочно скучный: форма запроса остается той же, меняется только model ID на gemini-3-pro-image-preview. Именно поэтому workflow "сначала Nano Banana 2, потом Pro при явной причине" настолько практичен: вам не нужно переписывать всю интеграцию только ради теста премиального tier.

Какие возможности уже есть в официальном 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 поддерживает imageConfig.aspectRatio, а для текущих preview 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 показывает для обеих preview image models статус Free Tier: Not available. По состоянию на 29 марта 2026 года официальный прайс такой:

Как только вы держите в голове эту таблицу, многие страницы из выдачи начинают читаться иначе. Если какая-то страница намекает, что текущее preview-image API Nano Banana "как бы free to start", но не раскладывает контракт, почти наверняка она смешивает:

• бесплатную выдачу ключа
• пробную риторику AI Studio
• consumer quotas в Gemini или AI Mode
• старые или вообще другие free-tier stories

Это не один и тот же контракт.

У потребительских входов, конечно, есть собственные правила. Gemini Apps Help сейчас документирует для Nano Banana 2 20 / 50 / 100 / 1000 images / day для no plan / Google AI Plus / Google AI Pro / Google AI Ultra. AI Mode Help показывает такую же форму 20 / 50 / 100 / 1000 images in a 24-hour period и отдельно пишет, что Nano Banana Pro in AI Mode optimized for infographics and diagrams. Эти факты полезны, если вы выбираете путь как пользователь. Но они не делают текущий preview image API бесплатным.

Если ваш настоящий вопрос — "сколько стоит Nano Banana как API", то идите дальше в наш гайд по ценам Nano Banana 2 API и разбор цен Gemini 3 Pro Image API. Здесь мы сначала решаем вопрос маршрута и подключения, а не полный 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-preview, если только вы заранее не знаете, что вам нужен более дорогой Pro tier.

Какой официальный model ID у Nano Banana Pro?
gemini-3-pro-image-preview.

Nano Banana API бесплатный?
Согласно текущей pricing page, сами preview image models не имеют free tier для image output. Consumer quotas и AI Mode usage — это отдельные контракты.

Что выбрать: AI Studio или Gemini API?
Лучше использовать оба: AI Studio для официальной проверки prompt-поведения, Gemini API — для продовой интеграции в приложение.

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 должен быть осознанным инфраструктурным выбором, а не стартовой точкой по умолчанию.