Nano Banana Pro

API редактирования изображений Nano Banana Pro на E2X

Nano Banana Pro — это gemini-3-pro-image от Google, верхний тариф семейства Nano Banana и тот, за которым мы тянемся, когда правка должна выдержать полный размер. Мы отдаём её capability редактирования как google/nano-banana-pro/edit-image и берём $0.075 за отредактированное изображение на 1K и 2K. Это половина того, во что тот же request обходится сегодня на fal.ai или Replicate.

Нет исходного изображения, с которым работать? Тогда вам нужен Nano Banana Pro text-to-image — та же модель, та же цена, только prompt.

Вот как выглядела наша цена, когда мы сверяли её в последний раз, 26 августа 2026 года:

Мы ставим дату на эту таблицу, потому что перепроверяем её и потому что цены двигаются.

Цены и условия продуктов со временем меняются; проверьте актуальные цены каждого провайдера, прежде чем принимать решение о покупке. Цены Google Batch или Flex не эквивалентны напрямую стандартному on-demand API request, поскольку планирование, доступность и условия обработки отличаются; поэтому они исключены из этого сравнения. Это ограниченное по охвату сравнение, а не утверждение, что E2X — самый дешёвый вариант в мире при любой конфигурации.

Где тариф Pro отрабатывает свою цену

Большинство моделей изображений воспринимают правку как новую генерацию, которая просто похожа на оригинал. Эта воспринимает её как композицию, и разницу вы чувствуете в трёх местах.

Она держит четырнадцать референсов разом. Google делит этот бюджет по ролям: до 5 изображений персонажа, когда человек должен остаться узнаваемым, до 6 изображений объекта для высокоточного продакт-плейсмента, до 3 референсов стиля. Полная рекламная композиция — модель, продукт, брендовая палитра — уходит одним request вместо цепочки из трёх вызовов, за которой надо приглядывать.

Она пишет читаемый текст. Это главная причина, по которой мы советуем Pro вместо более дешёвых тарифов для всего коммерческого. Она рисует стилизованный читаемый текст для инфографики, меню, схем и упаковки и справляется с многоязычными макетами: дайте ей английскую инфографику, попросите испанскую версию — и остальная графика останется на месте. Большинство моделей изображений до сих пор превращают основной текст в декоративные закорючки.

Разрешение, которое куда-то ведёт. 1K, 2K или 4K вплоть до 4096×4096. 1K и 2K мы оцениваем одинаково, в $0.075; 4K удваивает.

Одно поведение, о котором стоит знать до того, как вы сравните нас с кем-либо: модель порождает промежуточные «мысленные изображения», пока рассуждает о композиции. Google их не возвращает, и мы их не тарифицируем. Поэтому же ждите примерно 30 секунд на request, а не двух-трёх, за которые справилась бы модель flash-уровня.

API request: редактирование с референсами

Создайте ключ в дашборде, держите его на сервере и отправьте job на наш submit endpoint. Мы требуем два поля: prompt и image_urls.

curl -X POST https://api.e2x.ai/v1/jobs/submit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro/edit-image",
    "input": {
      "prompt": "Поставь бутылку на мокрый сланец при мягком пасмурном дневном свете. Текст на этикетке оставь резким и без изменений.",
      "image_urls": [
        "https://example.com/product.jpg",
        "https://example.com/mood.jpg"
      ],
      "aspect_ratio": "4:5",
      "resolution": "2k"
    }
  }'

Мы отдаём job ID. Опрашивайте его, пока статус не установится:

const headers = {
  Authorization: `Bearer ${process.env.E2X_API_KEY}`,
  "Content-Type": "application/json",
};

const submitted = await fetch("https://api.e2x.ai/v1/jobs/submit", {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "google/nano-banana-pro/edit-image",
    input: {
      prompt: "Замени фон на залитый солнцем миланский внутренний двор. Лицо и одежду человека оставь идентичными.",
      image_urls: ["https://example.com/portrait.jpg"],
      aspect_ratio: "16:9",
      resolution: "1k",
    },
  }),
}).then((r) => r.json());

const jobId = submitted.data.jobId;

while (true) {
  const job = await fetch(`https://api.e2x.ai/v1/jobs/${jobId}`, { headers })
    .then((r) => r.json());

  if (job.data.status === "completed") {
    console.log(job.data.outputs[0].url);
    break;
  }
  if (job.data.status === "failed") {
    throw new Error(job.data.error?.message || "Image edit failed");
  }
  await new Promise((r) => setTimeout(r, 2000));
}

Статус идёт pending → processing → completed либо останавливается на failed или cancelled. Не хотите опрашивать? Пришлите webhookUrl в теле submit, и мы позвоним, когда всё будет готово.

Две детали схемы, которые кусаются: значение aspect ratio по умолчанию у нас 9:16, а не 1:1, поэтому задавайте его явно, если вам не нужен портрет, — и значения resolution пишутся в нижнем регистре (1k, 2k, 4k). Живая машиночитаемая спецификация всегда несёт актуальную schema и цену.

Как выбрать между нашими моделями редактирования изображений

Pro — самый дорогой наш редактор изображений, и для многих задач он реально избыточен. Вот честная карта того, что у нас ещё есть:

Перечитайте таблицу и обратите внимание на строку legacy. Google выводит gemini-2.5-flash-image из эксплуатации 2 октября 2026 года, а Nano Banana 2 Lite и дешевле, и новее её — $0.0238 против $0.0312. Если вы всё ещё на старой, такая миграция окупается дважды. Мы скорее скажем вам это, чем продадим тариф, который вам не нужен.

Остальное — вопрос бюджета. Pro стоит примерно втрое дороже Lite. Если ваши правки — это замены фона и смена цвета в разрешении для соцсетей, Lite это умеет, а разницу вы оставите себе. Если клиент будет читать слова, впечатанные в изображение, возвращайтесь к Pro. Смотрите всё в категории image-to-image или в полном каталоге моделей.

Описывайте в prompt разницу, а не картинку

Привычка, перенесённая из text-to-image, — описать всю сцену. В правке такая инструкция воюет с референсом, и вы получаете уплывающую перегенерацию вместо изменения.

Пишите дельту. Назовите, что двигается, потом назовите, что не должно: «замени куртку на угольно-серую шерсть, позу, лицо и свет оставь идентичными» почти всегда бьёт полное описание сцены. Когда в один вызов идёт несколько референсов, подпишите их — «изображение 1 — человек, изображение 2 — продукт, изображение 3 — только цветокоррекция», — потому что больше ничто не скажет модели, что третье вложение было палитрой, а не объектом.

Правите текст? Процитируйте точную строку. Пересказ приглашает к переосмыслению.

Перед выкаткой

Каждый результат несёт водяной знак SynthID. Это незаметная метка происхождения от Google, она накладывается без исключений, и ни мы, ни любой другой провайдер не можем дать переключатель, чтобы её отключить. Если ваш пайплайн прогоняет детекцию ниже по цепочке или договор с клиентом запрещает материалы с водяным знаком, решите это до интеграции.

Следите за значениями разрешения по умолчанию, если переносите конфиг. У нас по умолчанию 1K, у fal.ai тоже; у Replicate по умолчанию 2K. Здесь цена на этих уровнях одинаковая, но размеры вашего вывода не совпадут с тем, что вы предполагали.

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

Что такое Nano Banana Pro?

Nano Banana Pro — продуктовое название gemini-3-pro-image от Google, премиального тарифа семейства Nano Banana. Он нацелен на сложную визуальную работу — композицию из множества референсов, консистентность персонажа, читаемый текст в кадре, вывод вплоть до 4K, — а не на максимально быструю генерацию.

Сколько стоит редактирование изображений Nano Banana Pro на E2X?

Мы берём $0.075 за отредактированное изображение в разрешении 1K и 2K, а 4K тарифицируется вдвое. Такой была наша цена на момент проверки 26 августа 2026 года. Цены двигаются, поэтому сверьтесь на живой странице модели, прежде чем строить на них бюджет.

Сколько референсных изображений вмещает один request?

Четырнадцать в сумме. Google ограничивает состав по ролям: не более 5 изображений персонажа для консистентности, не более 6 изображений объекта для высокоточного включения и не более 3 референсов стиля.

E2X дешевле fal.ai и Replicate для этой модели?

Для сопоставимых on-demand цен, которые мы проверяли в тот день, — да: $0.075 у нас против $0.15 у обоих. Это экономия 50% на равнозначном request. Другие тарифные планы, batch-продукты и промо-цены в это сравнение не входят.

Несут ли сгенерированные изображения водяной знак?

Да. Каждое изображение от Nano Banana Pro содержит водяной знак SynthID — незаметную метку Google для контента, сгенерированного ИИ. Ни один провайдер не даёт параметра, чтобы его выключить, мы в том числе.

Что использовать — Pro или один из более дешёвых тарифов?

Берите Pro, когда на изображении есть читаемый текст, когда вы соединяете несколько референсов или когда нужен 4K. Для замены фона и простой ретуши в разрешении для соцсетей Nano Banana 2 Lite стоит втрое дешевле, а разница видна редко.

API синхронный?

Нет. Вы отправляете job, а затем либо опрашиваете его статус, либо даёте нам webhookUrl. Завершённый job отдаёт результат по адресу data.outputs[0].url. Ждите около 30 секунд обработки.