![]()
Попросить нейросеть заменить фон легко. Сложнее добиться, чтобы вместе с фоном не изменились форма предмета, цвет ткани и мелкая надпись. Nano Banana — семейство моделей генерации и редактирования изображений; для практического приложения стоит выбрать конкретную версию и отдельно описать то, что должно остаться неизменным.
В Чатиуме можно собрать редактор вариантов: исходная картинка, короткое задание, несколько результатов и ручное подтверждение. Начните с ограниченной операции, например подготовки нейтрального фона для предметной фотографии.
Создай редактор предметных фото с Nano Banana. Я загружаю изображение и описываю новый фон. Сохраняй форму, цвет, пропорции и надписи на предмете. Показывай оригинал рядом с результатом, позволяй отметить ошибки и сохраняй выбранный вариант без автоматической публикации.
Почему важно название конкретной модели
В актуальной документации Google есть несколько моделей Nano Banana с разными задачами и ограничениями. Здесь используем Nano Banana 2.1, доступную в OpenRouter как google/gemini-nano-banana-2.1. Она поддерживает создание изображений и редактирование по тексту и исходной картинке.
Не переносите параметры из одной версии в другую только из-за общего прозвища. Разрешения, формат запроса и поддерживаемые функции нужно проверять для выбранного маршрута. В коротком примере ниже показан базовый вызов с текстом и изображением.
Задайте границу между изменением и сохранением
Для фотографии чашки требование может звучать так: «Замени серый фон на светлый деревянный стол. Не меняй чашку, ручку, рисунок и направление её поворота». Это понятнее, чем «сделай красивую предметную фотографию».
Но инструкция всё равно не является технической блокировкой пикселей. Проверяйте результат: не стала ли ручка другой формы, не добавилась ли лишняя тень, не исчез ли рисунок. Если нужна строгая неизменность объекта, процесс должен включать отдельную проверку или инструменты редактирования с более жёстким контролем области.
В Чатиуме список сохраняемых признаков можно показывать возле результата. Тогда пользователь оценивает соответствие задаче, а не просто выбирает самый приятный кадр.
Не редактируйте бесконечно поверх ошибок
После нескольких последовательных правок мелкие отличия могут накопиться. Храните исходник и историю веток: какой вариант был основой следующего шага. Если предмет уже изменился, очередная просьба «верни как было» может быть менее понятной, чем новый запуск от оригинала.
Проверяйте изображение в полном размере и в целевом кадрировании. Детали, незаметные в карточке предпросмотра, могут стать проблемой в каталоге. У принятого результата должны быть понятные назначение и версия задания.
Короткий вызов из Чатиума
Фрагмент выполняется на сервере: ctx приходит от платформы, imageUrl — проверенный адрес доступного модели исходника. done и failed — зарегистрированные маршруты результата и ошибки. В них проверяется вызывающее приложение: caller.type === 'plugin' && caller.appSlug === 'start'.
import { startCompletion } from '@start/sdk'
await startCompletion(ctx, {
model: 'google/gemini-nano-banana-2.1',
modalities: ['text', 'image'],
messages: [{ role: 'user', content: [
{ type: 'text', text: 'Замени фон на светлый. Предмет сохрани без изменений.' },
{ type: 'image', source: { type: 'url', url: imageUrl } },
] }],
onCompletionCompleted: done,
onCompletionFailed: failed,
})
Вызов возвращает идентификатор генерации, а результат приходит в onCompletionCompleted. Обработчик должен разбирать в ответе блоки изображений, а не только собирать текст. Загрузка исходника, сохранение результата и права доступа относятся к приложению.
Когда это полезно
Для подготовки вариантов и ограниченных визуальных изменений, которые человек может проверить. Если задача — найти совсем новый художественный образ, уместно сравнить подход с Midjourney. Если нужно точное доказательное изображение товара, оригинал остаётся обязательной точкой сверки.
Частые вопросы
Nano Banana — одно неизменное название API?
Нет. Это семейство; в примере указан конкретный ID версии 2.1, проверенный в каталоге на 24 октября 2026 года.
Просьба сохранить предмет гарантирует точность?
Нет. Это инструкция модели, поэтому результат нужно сопоставлять с исходником по важным деталям.
Почему обработчик должен читать изображения?
Потому что результат генерации может содержать блоки с картинками. Если сохранить только текстовые блоки, готовое изображение не попадёт в интерфейс.