Введение
Nano Banana 2 Редактирование изображения применяет Gemini 3.1 Flash Image от Google к уже имеющимся изображениям. Модель принимает от одного до четырнадцати исходников, сохраняет соотношение исходника или меняет его на одно из четырнадцати и рендерит в 0.5k, 1k, 2k или 4k.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| письменный бриф | Nano Banana 2 Текст в изображение |
| изображение, которое нужно изменить | Nano Banana 2 Редактирование изображения |
Ключевые возможности и особенности
До четырнадцати референсов
Объединяйте людей, одежду, обстановку и продукты из четырнадцати изображений, описывая роль каждого в промпте. Экономичный маршрут принимает до десяти; если их больше, правка выполняется на официальном маршруте, где каждый исходник добавляет небольшую фиксированную плату, так что передавайте только нужные для правки.
Перекадрирование при правке
Соотношение auto сохраняет форму исходника; одно из четырнадцати соотношений перекадрирует результат, как в нашем примере, где баннер 4:1 стал ночной сценой 16:9.
Быстро в любом размере
Те же уровни, что и в режиме «текст в изображение», от черновиков 0.5k до финала 4k, с ценой по уровню; на официальном маршруте добавляется небольшая плата за исходник.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Опишите объект, обстановку, свет и объектив полными предложениями; слова в кавычках рисуются как текст на изображении. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От 1 до 14 исходных изображений. Напишите в промпте, что даёт каждое: человека, обстановку, продукт. Не менее 1 элементов · Не более 14 элементов |
aspect_ratio | Нет | auto (по умолчанию) сохраняет соотношение исходного изображения; либо выберите одно из четырнадцати соотношений, включая крайние баннерные 4:1, 1:4, 8:1 и 1:8. |
resolution | Нет | 0.5k, 1k (по умолчанию), 2k или 4k. Квадратное изображение имеет сторону 512, 1024, 2048 или 4096 пикселей; у каждого уровня своя цена. |
enable_web_search | Нет | По умолчанию выключено. Если включить, модель перед рисованием проверяет актуальные факты: погоду, даты, достопримечательности. По умолчанию: |
enable_image_search | Нет | По умолчанию выключено. Если включить, модель перед рисованием ищет в интернете референсные изображения — это помогает с реальными местами и продуктами. По умолчанию: |
official_fallback | Нет | По умолчанию включено. Каждая правка сначала выполняется по эконом-маршруту. По умолчанию: |
Стоимость
Оплата за изображение по уровню размера. Каждая правка сначала идёт по экономичному маршруту по экономичной цене, без платы за исходники. Если включён Official fallback (по умолчанию включён), правка, которую экономичный маршрут отклонил или не смог выполнить, а также правка с более чем 10 исходниками выполняется на официальном маршруте по официальной цене, где за каждый исходник добавляется небольшая фиксированная плата; выключите Official fallback, чтобы платить только экономичную цену. Правки в 0.5k, а также с веб-поиском или поиском изображений выполняются на официальном маршруте, и каждый поиск добавляет плату. Расчёт стоимости показывает стартовую цену и максимум для правки. На официальном маршруте отказ, который приходит коротким текстовым ответом вместо изображения, считается завершённой генерацией и оплачивается по официальной цене; остальные отказы не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.036 / изображение |
| $0.0384 / изображение (С Official fallback: до $0.0536) |
| $0.0602 / изображение (С Official fallback: до $0.0808) |
| $0.0902 / изображение (С Official fallback: до $0.1208) |
Сценарии использования
Смена места и времени суток
Перенесите человека в новое место или превратите день в ночь для кампании, сохранив лицо, одежду и позу.
Адаптация готовых изображений к другим форматам
Превратите широкий баннер в версию 16:9 или 9:16 с новым содержанием по краям вместо простого кадрирования.
Композиции продуктов
Соберите несколько фото продуктов в одну оформленную сцену, назвав каждый продукт и его место.
Руководство по промптам и практические советы
Перечислите, что должно остаться
Описав изменение, назовите лицо, волосы, одежду и позу, которые нужно сохранить; модель соблюдает написанный список.
При перекадрировании опишите новый кадр
Когда меняется соотношение, напишите, что должно занять дополнительное место: больше неба, ещё один столик, продолжение улицы.
Поиск — только для реальных референсов
Включайте поиск изображений, только когда правка зависит от реального места или продукта, которые модели нужно увидеть.
Проверяйте правки в 0.5k
Сначала попробуйте указание в 0.5k; если правка работает, запустите тот же запрос в 2k или 4k.
Подбирайте уровень под исходник
Правка не добавит деталей, которых у исходника никогда не было; обычно хватает 2k, если только сам исходник не крупный.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-2/edit",
"input": {
"aspect_ratio": "auto",
"enable_image_search": false,
"enable_web_search": false,
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
