Nano Banana API в России: генерация и редактирование изображений через API

Nano Banana — семейство моделей Google для генерации и редактирования изображений. Оно стало популярным у e-commerce-команд и продуктовых разработчиков не из-за «красивых картинок», а из-за двух рабочих качеств: точного редактирования по текстовому описанию и стабильного внешнего вида персонажей и объектов в серии кадров. В этой статье — какие варианты Nano Banana доступны через PlusVibe API в России, как отправить запрос, сколько стоит одно изображение и как юрлицу оформить оплату в рублях.

Что такое Nano Banana и для чего она подходит

Nano Banana — это семейство изображенческих моделей в линейке Google Gemini. По публичной документации Google (ai.google.dev, раздел о генерации изображений) модели семейства умеют:

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

Чем Nano Banana отличается от других изображенческих моделей в нашем каталоге? Редактирование здесь выполняется по промпту, без маски: вы описываете словами, что убрать или заменить. Похожий сценарий есть у GPT Image 2 (генерация и редактирование, точная цена от 5 ₽ за изображение) и Flux Kontext (редактирование и image-to-image). Если главная задача — надписи в кадре, сильнее Ideogram v3; если нужен персонаж как самостоятельный актив — смотрите на Ideogram Character. Но именно связка «редактирование по промпту + консистентность серии» — профиль Nano Banana.

На практике для интернет-торговли это означает такой конвейер: один удачный кадр товара становится исходником для всей серии. Из него делают сцену на светлом фоне для главной карточки, вертикальный кадр 9:16 для сторис и баннер 16:9, при этом сам товар на всех кадрах остаётся узнаваемым. Правки «убрать блик», «заменить фон», «добавить место под текст» выполняются одним запросом на редактирование, без пересъёмки и без ручного фотомонтажа.

Прямой доступ к Google из России

Google официально не предоставляет доступ к Gemini API (через который работают модели Nano Banana) разработчикам из России: регион не входит в список поддерживаемых, оплата зарубежными способами российскими картами невозможна. Обход через VPN и иностранные карты работает нестабильно и рискует блокировкой аккаунта.

Рабочий путь для команды в России — российский API-сервис, который держит доступ к моделям на своей инфраструктуре: вы отправляете запрос на российский эндпоинт с ключом sk-pv-…, получаете результат и платите в рублях. PlusVibe API поддерживает три варианта Nano Banana — все тарифицируются за изображение.

Какие модели Nano Banana доступны в каталоге

В медиа-каталоге PlusVibe (GET /api/media-catalog, публично и без ключа) семейство представлено тремя позициями. Цены — ориентировочные, в рублях за одно изображение, на 28 августа 2026 года:

Стартовые цены соответствуют полю fromRub медиа-каталога (2,32 ₽, 4,91 ₽ и 15,07 ₽ соответственно), цены конфигураций — полям priceRub. Ответ каталога помечен pricesAreEstimate: true: итоговая сумма зависит от выбранных параметров и приходит в поле priceRub готовой задачи. Единица тарификации у всех трёх — «за изображение». Актуальный прайс всегда виден на plusvibeapi.ru/models.

Как выбрать между ними:

• gemini-3.1-flash-image — массовая генерация и быстрые правки, когда важен бюджет: минимальная цена семейства, есть редактирование.
• nano-banana-2 — генерация с нуля, когда нужен выбор между дешёвым тарифом Lite и Standard с разрешениями вплоть до 4K; редактирование не поддерживается.
• nano-banana-pro — финальные материалы: максимальные качество и детализация, редактирование по промпту, разрешения до 4K.

Как сгенерировать изображение через API

Генерация медиа — асинхронная: запрос создаёт задачу, вы опрашиваете её до готовности. Используется тот же ключ sk-pv-…, что и для чат-моделей.

Шаг 1. POST /api/media/generate — создать задачу:

curl -X POST https://plusvibeapi.ru/api/media/generate \
  -H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "Предметная фотография керамической кружки бежевого цвета на светлом фоне, мягкие тени, минимализм",
    "opts": { "aspect_ratio": "1:1", "tier": "standard", "resolution": "1K" }
  }'
# → {"ok":true,"jobId":"…","status":"processing"}

Шаг 2. GET /api/media/jobs/{id} — опросить задачу (рекомендуемый интервал 3–5 секунд):

curl https://plusvibeapi.ru/api/media/jobs/JOB_ID \
  -H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ"
# → {"status":"success","resultUrls":["https://…"],"priceRub":4.91}

Статусы: processing (задача выполняется), success (готово, списание по факту) и fail (ошибка, без списания).

Редактирование изображения выполняется так же: в opts добавляется режим edit и исходное изображение публичной HTTPS-ссылкой. Пример для Nano Banana Pro — заменить фон товарного фото:

curl -X POST https://plusvibeapi.ru/api/media/generate \
  -H "Authorization: Bearer sk-pv-ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "Замени фон на светлую студию с мягкой тенью. Товар не меняй: сохрани форму, цвет и положение.",
    "opts": {
      "mode": "edit",
      "image_url": "https://example.com/photos/product.jpg",
      "aspect_ratio": "4:3",
      "resolution": "1K"
    }
  }'

Тот же поток на Python:

import requests, time

BASE = "https://plusvibeapi.ru"
HEADERS = {"Authorization": "Bearer sk-pv-ВАШ_КЛЮЧ"}

job = requests.post(f"{BASE}/api/media/generate", headers=HEADERS, json={
    "model": "nano-banana-pro",
    "prompt": "Убери лишние предметы со стола, оставь только кружку.",
    "opts": {"mode": "edit", "image_url": "https://example.com/photos/product.jpg"},
}).json()

while True:
    res = requests.get(f"{BASE}/api/media/jobs/{job['jobId']}", headers=HEADERS).json()
    if res["status"] in ("success", "fail"):
        break
    time.sleep(4)

print(res["status"], res.get("resultUrls"), res.get("priceRub"))

Поддерживаемые параметры: aspect_ratio (1:1, 16:9, 9:16, 4:3, 3:4), у nano-banana-pro — resolution (1K/2K/4K), у nano-banana-2 — tier (lite/standard) и разрешение у тарифа Standard. Исходные изображения принимаются публичными HTTPS-ссылками (а также data:-строками или id файлов file-pv-… из /v1/files): для редактирования на nano-banana-pro — до 8 изображений, на gemini-3.1-flash-image — до 10. Полные контракты и примеры — в документации по генерации медиа.

Сколько это стоит: пример расчёта

Списание происходит за каждое готовое изображение и только при статусе success — ошибка провайдера ничего не стоит. Пример для магазина, который обновляет карточки товаров (цены ориентировочные, на 28 августа 2026 года):

• 100 новых изображений на nano-banana-2 (Standard, 1K) по 4,91 ₽ — 491 ₽;
• 50 правок фона на nano-banana-pro (1K) по 15,07 ₽ — 753,50 ₽;
• итого серия из 150 изображений — около 1 244,5 ₽.

Если бюджет важнее детализации, быстрая gemini-3.1-flash-image стартует от 2,32 ₽ за изображение: та же сотня карточек обойдётся примерно в 232 ₽ плюс правки.

Оплата и документы

• Оплата в рублях. Баланс пополняется в рублях (карта РФ, СБП, счёт для юрлица/ИП); списание — по факту каждой готовой генерации.
• Закрывающие документы через ЭДО. Документы формируются по фактически потреблённым услугам за календарный месяц и направляются через ЭДО. Исполнитель — ИП на УСН, поэтому в счёте и первичном документе указывается «Без НДС».
• Постоплата для организаций. Договорная отсрочка платежа по ст. 823 ГК РФ, а не кредит: организация начинает с предоплаты, затем подаёт заявку. Первая ступень лимита — до 5 000 ₽ со сроком оплаты 14 календарных дней; после двух вовремя оплаченных периодов лимит может быть письменно увеличен до 10 000 ₽; большие суммы согласуются индивидуально. Полные условия — на странице постоплаты для юрлиц.

Честные ограничения

• Только асинхронная генерация. Синхронных изображенческих эндпоинтов нет: создаёте задачу и опрашиваете её (или настраиваете webhook). Генерация занимает секунды-минуты, в пике — дольше.
• Цены ориентировочные. Каталог отдаёт оценки (pricesAreEstimate: true); точная сумма списания известна после завершения задачи и приходит в её priceRub. Перед запуском сервис проверяет баланс: если денег на выбранную конфигурацию не хватает, запрос отклоняется с кодом 402 и ценой.
• nano-banana-2 не редактирует изображения — только генерация по тексту. Для правок берите nano-banana-pro или gemini-3.1-flash-image.
• У nano-banana-pro нет маски. Область правки задаётся только промптом; рисовать маску на исходнике бесполезно — модель её не принимает.
• Один запрос — одно изображение. Пакетной генерации нескольких вариантов в одном запросе нет; соотношения сторон — только из пяти готовых пресетов; управление seed у моделей семейства не поддерживается.
• Исходное изображение должно быть доступно по публичной ссылке. Закрытые ссылки и внутренние адреса провайдер не прочитает.
• Если задача упала — списания нет, в ответе приходит безопасное описание причины. При нетерминальном статусе media_submission_uncertain не создавайте дубликат запроса — продолжайте опрашивать тот же jobId.

Итог

Nano Banana в PlusVibe API — это три маршрута под разные задачи: дешёвая массовая генерация (gemini-3.1-flash-image, от 2,3 ₽), гибкая генерация с тарифами (nano-banana-2, от 4,9 ₽) и качественная генерация с редактированием по промпту (nano-banana-pro, от 15 ₽ за изображение). Всё работает из России без VPN: рублёвый баланс, счета и закрывающие документы через ЭДО, постоплата для юрлиц по договору. Начните с одного тестового изображения — запрос занимает пять минут, а актуальные параметры и цены всегда видны в каталоге моделей и в документации медиа-генерации.