Nano Banana

API редактирования изображений Nano Banana на E2X: три референса и дата отключения

Возможность редактирования у Nano Banana — это gemini-2.5-flash-image от Google, принимающий исходные изображения вместо чистого холста. Мы отдаём её на google/nano-banana/edit-image за $0.0312 за отредактированное изображение — на 20% ниже fal.ai — и она принимает максимум три референсных изображения при выводе 1K. Прежде чем вы напишете строчку интеграционного кода, на первом месте должно стоять одно: Google выводит эту модель из эксплуатации 2 октября 2026 года.

Тридцать семь дней, считая от дня, когда эта страница вышла. Существующие пайплайны до тех пор работают, и наша цена не двигается. Но продать вам редактор с пятинедельным таймером — значит купить вам переписывание в октябре.

Наша цена против рынка, сверено 26 августа 2026 года:

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

Почему мы начинаем с уведомления о выводе из эксплуатации

Потому что так делает Google. Объявляя Nano Banana 2 Lite, компания написала:

«Это наша рекомендованная замена для разработчиков, которые сейчас используют первую версию Nano Banana (gemini-2.5-flash-image); вы можете переключиться прямо сейчас и сразу получить выгоду».

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

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

Потолок в три референса

Это то число, которое отделяет legacy-редактор от всего более нового в семействе. Указание Google однозначное: для лучших результатов с Gemini 2.5 Flash Image включайте во вход максимум три изображения.

Трёх хватает на большой объём реальной работы. Объект, подложка фона, цветовой референс — такая композиция помещается. Не помещается рекламный бриф, где персонаж, продукт, реквизит и брендовая палитра приходят одним вызовом. Nano Banana Pro берёт четырнадцать референсов ровно под эту задачу. Здесь вместо этого вы выстраиваете цепочку вызовов, платите за каждый шаг, и каждый шаг уводит дальше от оригинала.

Ещё пара ограничений, которые стоит держать перед глазами, прежде чем проектировать под эту модель:

• Вывод упирается в 1K. Более крупного тарифа в этом поколении нет, что бы ни намекало поле схемы.
• Не просите её исправить текст на изображении. Рендеринг текста в кадре — сильная сторона Gemini 3, а не этой модели. Заменить цену на этикетке или перевести вывеску — самый частый сценарий провала.
• Доступны десять aspect ratio, от 21:9 до 4:5, и исходное изображение не запирает вас в своём.
• Бюджет токенов — 65 536 на вход и 32 768 на выход, с knowledge cutoff в июне 2025 года, так что референсы чего-то недавнего безопаснее, чем его описания.

API request: редактирование по исходным изображениям

Обязательных полей два: 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/edit-image",
    "input": {
      "prompt": "Смени стену за креслом с белой на тёмно-оливковую. Кресло, пол и тени оставь ровно такими, как они есть.",
      "image_urls": [
        "https://example.com/interior.jpg"
      ],
      "aspect_ratio": "4:5"
    }
  }'

Отправка возвращает 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/edit-image",
    input: {
      prompt: "Изображение 1 — велосипед, изображение 2 — локация. Поставь велосипед на брусчатку с изображения 2, подогнав его под пасмурный свет.",
      image_urls: [
        "https://example.com/bike.jpg",
        "https://example.com/street.jpg",
      ],
      aspect_ratio: "1:1",
    },
  }),
}).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 || "Edit failed");
  }
  await new Promise((r) => setTimeout(r, 2000));
}

Статусы идут pending → processing → completed, а failed и cancelled — терминальные состояния. Передайте webhookUrl, чтобы вообще обойтись без polling. По умолчанию у нас aspect_ratio равен 9:16 — задайте его, иначе горизонтальный исходник вернётся вертикальным. Живая schema лежит в машиночитаемой спецификации этой модели.

Замена, которую мы советуем, и почему она вам ничего не стоит

Все редактирующие модели, которые мы держим, с ценой за изображение:

Обычно миграция — это сделка: модель новее, счёт выше, нужна подпись начальства. Здесь не так. Nano Banana 2 Lite на 24% дешевле legacy-редактора и на поколение впереди него, а значит финансовый разговор и инженерный разговор заканчиваются одинаково. Прогоняйте тысячу правок в месяц — оставите себе около $9 и при этом получите результат лучше.

Мы скорее скажем это прямо, чем будем держать вас на slug, срок которого нам известен. Если в ваших правках участвует читаемый текст — съёмка упаковки, меню-борды, локализованные креативы — поднимайтесь выше Lite, к Nano Banana Pro: именно туда Google положил многоязычный рендеринг текста. Остальное смотрите в категории image-to-image или во всём нашем каталоге моделей.

Привычки редактирования, которые переезжают вместе с вами

Хорошая новость про миграцию: дисциплина работы с prompt переносится целиком, так что всё, чему вы научитесь на этой неделе, не пропадёт.

Назовите изменение, потом назовите константы. «Перекрась диван в ржаво-льняной; подушки, узор ковра и свет из окна не трогай» держится куда лучше, чем переписанное описание сцены. Инстинкт описывать картинку целиком приходит из text-to-image, а в правке он конкурирует с референсом, пока модель не начнёт генерировать заново вместо того, чтобы подправлять.

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

Проверки перед вылетом

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

Оставьте resolution на 1k — вот это стоит денег. В нашей схеме поле resolution одинаково для всего семейства Nano Banana, поэтому этот endpoint без возражений примет от вас 2k и 4k. Веса Google их не отработают. gemini-2.5-flash-image выдаёт 1K и ничего выше, так что request, отправленный с 4k, тарифицируется по нашему множителю 2× — $0.0624 вместо $0.0312 — и возвращает ровно то же изображение 1K, которое вы получили бы вдвое дешевле. Мы предпочитаем предупредить, а не собрать эти деньги. У более новых тарифов лестница разрешений настоящая: Nano Banana Pro реально рисует вплоть до 4096×4096.

Поставьте напоминание в календарь, а не тикет в бэклог. 2 октября 2026 года апстрим-модель перестаёт отвечать, и всё, что до сих пор смотрит на этот slug — cron-задача, кнопка на клиентском интерфейсе, ночной batch — падает в этот день. Поменять одну строку сейчас лучше, чем отлаживать это тогда.

Что нас спрашивают про legacy-редактор

Сколько референсных изображений принимает Nano Banana edit-image?

Максимум три. Собственное указание Google для gemini-2.5-flash-image — включать во вход не более трёх изображений, дальше качество деградирует. Для более тяжёлых композиций Nano Banana Pro тянет до четырнадцати референсов, разложенных по ролям персонажа, объекта и стиля.

Что станет с моей интеграцией 2 октября 2026 года?

Requests к google/nano-banana/edit-image перестанут выполняться, потому что Google выводит базовые веса из эксплуатации везде, а не только на нашей платформе. Ни один провайдер не может продолжать обслуживать модель, которую вендор выключил. Переходите на Nano Banana 2 Lite до этой даты.

Правда ли Nano Banana 2 Lite дешевле legacy-модели?

Да — $0.0238 за правку против $0.0312 здесь, разница 24%, и на более новых весах. Google формулирует это так же, ссылаясь на лучшее качество, более быструю генерацию и более низкую цену. Это редкий апгрейд без компромисса по стоимости.

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

$0.0312 за отредактированное изображение при разрешении 1k по умолчанию, на 20% ниже $0.039, которые мы зафиксировали у fal.ai, Gemini API от Google и OpenRouter 26 августа 2026 года. Приложить один референс или три стоит одинаково, но отправка resolution: "4k" применяет множитель 2× за результат, который эта модель на самом деле выдать не может — оставьте 1k. Перед фиксацией бюджета сверьтесь на живой странице модели.

Может ли она редактировать или переводить текст внутри изображения?

Надёжно — нет. Продвинутый рендеринг текста принадлежит поколению Gemini 3, а эта модель ему предшествует, поэтому отредактированные слова часто возвращаются искажёнными или переосмысленными. Nano Banana Pro — тот тариф, который построен под читаемый многоязычный текст в кадре.

Остаётся ли на отредактированном изображении водяной знак?

Да. SynthID вшит в каждый результат этой модели ровно так же, как и в capability text-to-image. Это метка происхождения от Google, и ни один провайдер не даёт способа её выключить.

Чем capability edit отличается от text-to-image?

Те же веса, та же цена $0.0312, разный вход. Edit-image требует image_urls рядом с вашим prompt и меняет то, что вы ему дали; text-to-image берёт один prompt и строит с нуля. Выбирайте по тому, существует ли уже исходное изображение.