Nano Banana API в Vertex AI: рабочие модели, настройка и цена

Обновлено 8 октября 2026 года: в Vertex AI появилась Nano Banana 2.1 (gemini-nano-banana-2.1, GA с 6 октября 2026 года, только location global), добавлены её цены и ограничения на параметры, уточнены сроки Nano Banana 2 и gemini-2.5-flash-image. Настройка клиента не изменилась.

С 22 апреля 2026 года Vertex AI входит в Gemini Enterprise Agent Platform, но API остался на прежнем хосте aiplatform.googleapis.com, и Nano Banana вызывается там же. Рабочие идентификаторы — только общедоступные (GA): gemini-nano-banana-2.1 (Nano Banana 2.1), gemini-3.1-flash-image (Nano Banana 2), gemini-3-pro-image (Nano Banana Pro), gemini-3.1-flash-lite-image (Nano Banana 2 Lite) и устаревающий gemini-2.5-flash-image. Новый проект разумно начинать с 2.1. Nano Banana 2 в Vertex по-прежнему GA с выводом из эксплуатации «May 28, 2027 or later», так что переезжать с неё срочно не нужно. Версии с суффиксом -preview на платформе отключены 17 июля 2026 года, и чаще всего именно из-за них перестаёт работать код из туториалов 2025 года.

Минимальная настройка — SDK google-genai, переменные GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION=global, GOOGLE_GENAI_USE_ENTERPRISE=True и учётные данные Google Cloud (ADC или сервисный аккаунт). Прайс совпадает с платным Gemini API: кадр Nano Banana 2.1 стоит $0,0336 в 1K, $0,0504 в 2K и $0,1134 в 4K, кадр Nano Banana 2 — около $0,10 в 2K и $0,15 в 4K; дороже только multi-region us/eu для Nano Banana 2 (+10 %). Vertex оправдан, когда нужны IAM, сервисные аккаунты, VPC-SC, CMEK, резидентность данных или Provisioned Throughput; для прототипа Google сам советует обычный ключ Gemini API.

Отдельно для читателей в России: по документации Google Cloud Billing, с 10 марта 2022 года Google Cloud приостановил регистрацию новых аккаунтов для пользователей в России (формулировка источника: «has paused new account sign ups for users in Russia»), а в списке стран, где доступны Google AI Studio и Gemini API, России тоже нет. Статус аккаунтов, созданных до этой даты, там не описан. Техническая часть ниже пригодится тем, у кого уже есть законный доступ к проекту Google Cloud.

Какие модели Nano Banana работают в Vertex AI

По страницам моделей и таблице версий Agent Platform по состоянию на 8 октября 2026 года картина такая:

Даты вывода в этой таблице Google относит именно к Agent Platform («retirement of support in Gemini Enterprise Agent Platform»): в Gemini API у тех же ID свой график. Для замены старых preview-идентификаторов в release notes от 17 июля есть опечатка (gemini-3-flash-image); правильный ID Nano Banana Pro — gemini-3-pro-image, так он записан и на странице модели, и в таблице устаревших версий.

Коротко о возможностях. Nano Banana 2.1 принимает до 14 изображений в запросе, на странице модели в Vertex перечислены 15 соотношений сторон (включая 1:4, 4:1, 1:8, 8:1, 21:9 и 9:21), есть опора на Google Поиск и поиск по картинкам, поддерживается режим размышления (thinking). Параметры seed, topK, logprobs, temperature и topP у 2.1 не поддерживаются: если передать любой из них, API вернёт ошибку. Nano Banana 2 поддерживает те же 15 соотношений сторон и вдобавок размер 512. Nano Banana Pro тоже принимает до 14 изображений (inline-файл до 7 МБ, из Cloud Storage до 30 МБ), умеет опираться на Google Поиск, но, как и 2.1, не поддерживает вызов функций и выполнение кода. У Lite — только 1K и 14 соотношений сторон. Дообучение (tuning) ни для одной из моделей не поддерживается.

Почему ломается код из старых туториалов

Первая причина — preview-идентификаторы. SDK их не проверяет: в google-genai 2.25.0 (вышла 22 сентября 2026 года) клиент с enterprise=True без возражений собирает адрес .../models/gemini-3.1-flash-image-preview:generateContent точно так же, как для GA-модели. Ошибка появится только в ответе сервера, поэтому по локальному коду её не заметить. Такие маршруты и тексты ошибок SDK можно воспроизвести локальной сборкой клиента без обращения к Google; скорость генерации и ответы сервера так, разумеется, не проверить.

Вторая причина — одинаковые названия моделей на двух платформах живут по разным графикам. Nano Banana 2 в Gemini API (ключ AI Studio) объявлена устаревшей без даты отключения, и Google советует переходить на gemini-nano-banana-2.1, а в Vertex та же модель остаётся GA. Для gemini-2.5-flash-image на Agent Platform указано 15 марта 2027 года, а страницы Gemini API противоречат друг другу (подробнее — в сравнении ниже). Preview-версия Nano Banana 2 в Gemini API ушла 25 июня 2026 года, на Agent Platform — 17 июля. Поэтому совет из форума «у меня всё работает» может относиться к другой платформе.

Третья — флаг клиента. Старые примеры пишут vertexai=True; в SDK 2.25.0 он по-прежнему работает как устаревший синоним, а основным стал enterprise=True («Gemini Enterprise Agent Platform endpoints (previously Vertex AI API)», как сказано в docstring). Если в одном клиенте указать оба флага с разными значениями, SDK откажется создавать клиент.

Четвёртая появилась с выходом 2.1: если в существующем коде просто заменить ID на gemini-nano-banana-2.1, а в конфиге остались temperature, top_p, top_k, seed или logprobs, сервер ответит ошибкой. Перед переездом эти поля нужно убрать.

Nano Banana 2.1 или Nano Banana 2: какой ID брать в Vertex AI

Для нового проекта — gemini-nano-banana-2.1. Кадр 1K у неё стоит $0,0336 против $0,0672 у Nano Banana 2, кадр 2K — $0,0504 против $0,1008, и в 4K она тоже дешевле ($0,1134 против $0,1512). По внутренним оценкам из карточки модели Google, 2.1 выигрывает у Nano Banana 2 и Pro по общему предпочтению, редактированию и согласованности нескольких персонажей; это оценка самого Google. Подробно о самой модели — в материале Nano Banana 2.1: цена от $0,0336, вдвое ниже NB2 в 1K и 2K.

У 2.1 есть оговорка по сроку поддержки. В таблице версий Agent Platform она стоит среди моделей с коротким сроком доступности («Models available for shorter availability periods»): дата вывода не объявлена, а когда Google её назначит, на миграцию останется не меньше 45 дней. Nano Banana 2, Pro и Lite находятся в таблице моделей, доступных минимум 12 месяцев. Если команде нужен гарантированный срок поддержки, разумно остаться на Nano Banana 2 с её «May 28, 2027 or later».

Nano Banana 2 стоит оставить или выбрать, если нужно хотя бы одно из этого:

• размер 512 — у 2.1 минимальный размер 1K;
• обработка в us или eu ради резидентности данных: 2.1, как и Pro, доступна только на global;
• Flex PayGo: у 2.1 его нет, остаются Standard, Batch/Off-peak и Provisioned Throughput;
• управление через temperature, top_p, top_k или seed.

Торопиться с переездом в Vertex не нужно: Nano Banana 2 там GA, а дата вывода сформулирована как «May 28, 2027 or later». В Gemini API ситуация другая: модель помечена как устаревшая, дата отключения не объявлена (дату 29 октября 2026 года, которая была на странице в день выхода 2.1, Google потом убрал). Кто вызывает одну и ту же модель через оба маршрута, планирует миграцию по графику Gemini API.

Если на картинке важен точный текст, сравните 2.1 с Pro на своих промптах. В прогоне 9 одинаковых промптов (1K, по одному кадру на промпт) 2.1 в трёх задачах с надписями изменила заданную формулировку, а Pro её сохранила; детали — в материале Nano Banana 2.1 vs Pro vs GPT Image 2.5: сравнение на 9 задачах.

Vertex или ключ Gemini API: в чём разница

Модель одна и та же, различаются доступ, управление и эксплуатация.

Позиция Google в документации по миграции прямая: «Most developers should use the Gemini Developer API unless there is a need for specific enterprise controls». Отсюда простое правило.

• Оставайтесь на ключе Gemini API, если это прототип, небольшой сервис или личный проект и серверу достаточно хранить один ключ. Как устроен этот вариант, разобрано в материале Nano Banana API: документация, ключ и пошаговая инструкция.
• Идите через Vertex, если у компании уже есть организация и биллинг в Google Cloud, доступ нужно выдавать через IAM и сервисные аккаунты, требуются VPC-SC, CMEK, обработка данных в us или eu (для Nano Banana 2) либо гарантированная мощность через Provisioned Throughput.
• Ещё один повод — модели, которые в Gemini API уже помечены как устаревшие. У Nano Banana 2 на Agent Platform есть твёрдый ориентир «не раньше 28 мая 2027 года», у gemini-2.5-flash-image — 15 марта 2027 года, тогда как в Gemini API у первой даты нет вовсе, а у второй страницы Google называют разные. Но это отсрочка, а не решение: переезд на 2.1 или Lite всё равно понадобится.

Общий выбор платформы для Gemini, не только для изображений, подробно разобран в статье Gemini API или Vertex AI API: какой маршрут Google Gemini выбрать.

Если корпоративные механизмы Google Cloud не нужны вовсе, существуют и сторонние API-сервисы. Например, laozhang.ai продаёт вызовы gemini-nano-banana-2.1 по $0,045, gemini-3.1-flash-image по $0,055, gemini-3-pro-image по $0,09 и gemini-3.1-flash-lite-image по $0,025 за запрос независимо от разрешения (по состоянию на 8 октября 2026 года, документация laozhang.ai по Nano Banana 2.1). Это не Vertex: там нет VPC-SC, CMEK, резидентности данных, Provisioned Throughput и SLA Google, действуют условия самого сервиса, и применимость этих условий к вашей ситуации нужно проверять самостоятельно.

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

Первый вызов из Python

Ниже — вариант, который повторяет официальный пример Agent Platform, с явно заданными размером и соотношением сторон. В примере стоит Nano Banana 2.1; для Nano Banana 2 достаточно заменить ID на gemini-3.1-flash-image.

Через ADC и переменные окружения

pip install --upgrade google-genai pillow
gcloud auth application-default login
gcloud services enable aiplatform.googleapis.com

export GOOGLE_CLOUD_PROJECT=your-project-id
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

from io import BytesIO

from google import genai
from google.genai import types
from PIL import Image

client = genai.Client()  # проект, location и флаг берутся из переменных окружения

response = client.models.generate_content(
    model="gemini-nano-banana-2.1",  # или "gemini-3.1-flash-image" для Nano Banana 2
    contents="Кот-бариста за стойкой кофейни, мягкий утренний свет",
    config=types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],
        image_config=types.ImageConfig(aspect_ratio="16:9", image_size="2K"),
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
        print(part.text)
    elif part.inline_data:
        Image.open(BytesIO(part.inline_data.data)).save("result.png")

В SDK 2.25.0 такой конфиг превращается в generationConfig вида {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}}, а запрос уходит на https://aiplatform.googleapis.com/v1beta1/projects/.../locations/global/publishers/google/models/<ID модели>:generateContent: SDK подставляет ID в адрес как есть. Размер по умолчанию — 1K; значение 512 есть только у Nano Banana 2. Для Nano Banana Pro достаточно заменить ID на gemini-3-pro-image и не менять location: у Pro, как и у 2.1, есть только global. С 2.1 не добавляйте в GenerateContentConfig поля temperature, top_p, top_k и seed.

На сервере вместо gcloud auth application-default login обычно используют сервисный аккаунт с ролью на доступ к Agent Platform: SDK подхватит его через тот же механизм ADC.

Явные параметры и express mode

Если переменные окружения неудобны, параметры передаются прямо в клиент:

client = genai.Client(enterprise=True, project="your-project-id", location="global")

Express mode — упрощённый вход в Agent Platform для аккаунтов @gmail.com с ключом API вместо ADC:

client = genai.Client(enterprise=True, api_key="EXPRESS_MODE_API_KEY")

В этом режиме SDK обращается к aiplatform.googleapis.com без проекта и location. У express mode есть оговорки: он в статусе Preview; новым пользователям Google Cloud даётся 90 дней бесплатного уровня без платёжных данных в пределах квот, а у существующих пользователей и после подключения биллинга бесплатный уровень исчезает. Таблица моделей express mode до сих пор перечисляет gemini-3.1-flash-image-preview и gemini-3-pro-image-preview, которые уже отключены, а входят ли GA-версии Nano Banana в бесплатный уровень, там не сказано. Рассчитывать на бесплатную генерацию через express mode не стоит.

REST и консоль

Для проверки без SDK подойдёт curl с OAuth-токеном из gcloud. Официальные примеры REST используют версию v1:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://aiplatform.googleapis.com/v1/projects/${GOOGLE_CLOUD_PROJECT}/locations/global/publishers/google/models/gemini-nano-banana-2.1:generateContent" \
  -d '{
    "contents": {"role": "USER", "parts": [{"text": "Кот-бариста за стойкой кофейни"}]},
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }' > response.json

Изображение приходит внутри JSON как base64 в inlineData.data одной из частей ответа, поэтому файл ответа бывает большим. Если запросы идут через самостоятельно развёрнутый шлюз, проверьте, что его версия умеет работать с новыми моделями и крупными inline-ответами: на linux.do в сентябре 2025 года описывали случай, когда в Vertex AI Studio генерация шла, а через шлюзы new-api и done-hub — нет, пока клиент не обновили.

В консоли то же самое делается без кода: Agent Studio (бывшая Vertex AI Studio) → Create prompt → Switch model → в панели Outputs выберите «Image and text».

Две ловушки из официальной документации. Пример для Node.js на странице генерации изображений всё ещё использует vertexai: true и по умолчанию подставляет location us-central1, которого нет в списке ни для 2.1, ни для Nano Banana 2 и Pro, — задайте GOOGLE_CLOUD_LOCATION=global явно. А код с ai.google.dev, построенный на Interactions API и response_format, — это другой интерфейс: для клиента Agent Platform берите generateContent с imageConfig.

Location: global, us или eu

Location определяет и адрес запроса, и цену. Так его разрешает google-genai 2.25.0:

Для gemini-2.5-flash-image список регионов такой: us-central1, us-east1, us-east4, us-east5, us-south1, us-west1, us-west4, europe-central2, europe-north1, europe-southwest1, europe-west1, europe-west4, europe-west8. Азиатских региональных эндпоинтов нет ни у одной модели Nano Banana, так что закрепить генерацию за Азией не получится.

Правило выбора простое. Если нет требования держать обработку данных в США или ЕС, берите global: цена ниже, здесь доступны все модели, включая 2.1, а Google называет глобальный эндпоинт лучшей практикой из-за большего мультирегионального пула мощности и первым советует переходить на него при ошибках 429. us или eu нужны для резидентности данных и только с Nano Banana 2, за что придётся доплатить 10 %.

Сколько стоит одно изображение

Google тарифицирует выходные изображения токенами. Формула: цена кадра = токены изображения × цена за 1 млн токенов / 1 000 000. Цены за миллион выходных токенов изображения в Standard PayGo: Nano Banana 2.1 — $30 (только global), Nano Banana 2 — $60 на global и $66 на us/eu, Nano Banana Pro — $120, Lite — $30, gemini-2.5-flash-image — $30. Flex PayGo и Batch/Off-peak стоят половину от Standard; у 2.1 половинная цена действует для Batch/Off-peak ($15 за миллион токенов изображения), а Flex не поддерживается.

Цены — прайс-лист Agent Platform в долларах США по состоянию на 8 октября 2026 года; в прайсе Google 4K у 2.1 округлён до $0,113. Обратите внимание на Pro: 1K и 2K расходуют одинаковые 1 120 токенов, поэтому 2K у Pro обходится не дороже 1K. Более подробный разбор бюджета Nano Banana 2 с Batch и сравнением с 2.1 — в статье Цены Nano Banana 2 API: 512–4K, Batch, бюджет и сравнение с 2.1.

Пример: 1 000 изображений в 2K на global стоят у Nano Banana 2.1 1 000 × 1 680 × $30 / 1 000 000 = $50,40 в Standard и $25,20 в Batch, у Nano Banana 2 — 1 000 × 1 680 × $60 / 1 000 000 = $100,80 в Standard и $50,40 в Batch. Каждое референсное изображение на входе добавляет около $0,00168 у 2.1 (1 120 токенов × $1,50 за миллион), около $0,00056 у Nano Banana 2 (1 120 токенов × $0,50) и около $0,00112 у Pro (560 токенов × $2).

В таблицу не входят текстовые токены запроса и ответа, токены размышления (у 2.1 они тарифицируются по $7,50 за миллион вместе с текстовым выводом), неудачные и заблокированные попытки, а также опора на Google Поиск: на все модели Gemini 3 вместе бесплатно 5 000 поисковых запросов в месяц, дальше $14 за 1 000 (один запрос к модели может породить несколько поисковых). Поэтому считайте эти цифры нижней границей, а не прогнозом счёта.

Та же модель через платный Gemini API стоит столько же, сколько на global: Vertex не делает Nano Banana дешевле. Разница в деньгах может возникнуть только из-за кредитов. В условиях Google Cloud Free Trial сказано, что кредит $300 на 90 дней нельзя тратить на Gemini API в AI Studio, а собственные модели Gemini на Agent Platform в списке исключений не значатся; значит, пробный кредит, судя по формулировке, покрывает Nano Banana в Vertex.

Диагностика: от ValueError до 429

Сначала отделите ошибки, которые выдаёт сам SDK до отправки запроса, от ответов сервера. Тексты ниже взяты из google-genai 2.25.0; в других версиях формулировки могут отличаться.

429 при небольшой нагрузке

На Standard PayGo ошибка 429 приходит с текстом «Resource exhausted, please try again later.», при превышении выкупленной мощности — «Too many requests. Exceeded the Provisioned Throughput.».

Опубликованного лимита для моделей изображений нет. Уровни Standard PayGo, которые растут вместе с расходами организации, на Nano Banana не распространяются: на странице Standard PayGo модели Gemini 3.1 Flash Image, 3.1 Flash-Lite Image, 3 Pro Image и 2.5 Flash Image перечислены отдельно, с пометкой «the usage tiers don't apply to these models». Фиксированной квоты у них тоже нет (на страницах моделей, включая 2.1, — «Fixed quota: Not supported»), так что запрашивать её увеличение негде. Мощность для этих моделей общая и выделяется по возможности: при высоком спросе на платформе 429 может прийти и на паре запросов, а резкие всплески в пределах секунд Google отдельно называет причиной троттлинга.

Что делать, по рекомендациям Google:

1. Перейти с регионального эндпоинта на global: он открывает доступ к большему мультирегиональному пулу мощности.
2. Повторять запросы с усечённой экспоненциальной задержкой (truncated exponential backoff). В google-genai 2.25.0 повторы по умолчанию выключены: без retry_options клиент делает одну попытку. С HttpRetryOptions SDK повторяет ответы 408, 429, 500, 502, 503 и 504, по умолчанию до 5 попыток с учётом первой, с экспоненциально растущей паузой от 1 до 60 секунд.
3. Сглаживать трафик внутри минуты и наращивать нагрузку постепенно, а не пачками параллельных запросов.
4. Для задач, где троттлинг недопустим, покупать Provisioned Throughput — это выделенная и гарантированная мощность.

from google import genai
from google.genai import types

client = genai.Client(
    enterprise=True,
    project="your-project-id",
    location="global",
    http_options=types.HttpOptions(
        retry_options=types.HttpRetryOptions(attempts=5, initial_delay=2.0, max_delay=60.0),
    ),
)

Жалобы на постоянный 429 RESOURCE_EXHAUSTED при редких запросах к Nano Banana Pro через Vertex есть на форуме Google AI Developers: ветка открыта 2 января 2026 года, сотрудник Google написал, что исправление выкачено 8 января, отдельные сообщения продолжались в феврале и марте. Всё это относится ко времени preview-моделей, так что о надёжности нынешних GA-версий эти истории не говорят ни в ту, ни в другую сторону.

Если ошибки начались внезапно, без изменений в коде и настройках, полезно проверить, не общий ли это сбой: как отличить сбой Nano Banana 2 от проблемы на своей стороне. Лимиты варианта с ключом устроены иначе, про них — в статье Лимиты Nano Banana 2: сколько изображений в день в Gemini и API.

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

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

Гарантированно — нет. В Gemini API бесплатного уровня для Nano Banana 2.1, 2 и Pro нет. В express mode новые пользователи получают 90 дней бесплатного уровня, но таблица моделей этого режима перечисляет только отключённые preview-версии, и доступность GA-моделей там не подтверждена. Реальный вариант — кредит $300 Google Cloud Free Trial: исключение в условиях касается Gemini API в AI Studio, а не Agent Platform. Для пользователей в России новые аккаунты Google Cloud недоступны с 10 марта 2022 года.

Нужно ли срочно переводить Nano Banana 2 на 2.1 в Vertex AI?

Нет. На Agent Platform gemini-3.1-flash-image остаётся GA с выводом «May 28, 2027 or later». Новые проекты разумно начинать на gemini-nano-banana-2.1, если не нужен гарантированный срок поддержки (у 2.1 он короткий и не объявлен), а действующие переводить без спешки, предварительно убрав из конфига temperature, top_p, top_k и seed. Если у вас есть код на той же модели через ключ Gemini API, там она уже устарела, хотя дата отключения не объявлена.

Ставит ли Vertex водяной знак на изображения?

Видимого логотипа на картинке, полученной через API, нет, но это не значит «без водяного знака». В документации Gemini API сказано, что все сгенерированные изображения содержат невидимый водяной знак SynthID; в блоге Google Cloud встроенный SynthID упоминается и для Nano Banana на Vertex, а для Nano Banana 2 — вместе с Content Credentials (C2PA). Страницы моделей на Agent Platform, включая 2.1, тоже отмечают поддержку C2PA. Так что происхождение изображения от ИИ можно определить, даже если на глаз ничего не видно.

Можно ли дообучить Nano Banana Pro на своих данных в Vertex?

Нет. На страницах моделей Agent Platform для Nano Banana 2.1, 2, Pro и Lite в строке Tuning указано «Not supported». Инструкции о дообучении Nano Banana на Cloud TPU с этим расходятся, и полагаться на них не стоит. Стиль и персонажей удерживают референсными изображениями: 2.1, Nano Banana 2 и Pro принимают до 14 штук в запросе. Как собрать такой запрос в Gemini API, показано в разборе Nano Banana Pro API: официальный JSON, YAML, PDF и разбор ошибок; на Vertex структура contents та же, отличается только настройка клиента.

Что делать с кодом на gemini-2.5-flash-image?

На Agent Platform модель доступна до 15 марта 2027 года. В Gemini API страницы Google расходятся: таблица устаревших моделей тоже называет 15 марта 2027 года, а на странице цен осталось предупреждение об отключении 2 октября 2026 года. Не откладывайте миграцию в расчёте на позднюю дату. Официальная замена — gemini-3.1-flash-lite-image: кадр 1K у Lite дешевле ($0,0336 против примерно $0,039), но разрешение ограничено 1K. Если нужны 2K или 4K, переходите на gemini-nano-banana-2.1.