Введение
Nano Banana Pro Редактирование изображения применяет Gemini 3 Pro Image от Google к уже имеющимся изображениям. Модель принимает от одного до четырнадцати исходников, планирует правку до рендера и возвращает 1k, 2k или 4k в соотношении исходника или в одном из десяти соотношений.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| письменный бриф | Nano Banana Pro Текст в изображение |
| изображение, которое нужно изменить | Nano Banana Pro Редактирование изображения |
Ключевые возможности и особенности
Точные правки с одним изменением
Новый свет, новый фон или добавленный текст, пока люди и остальное изображение остаются прежними, как в наших примерах со свечами и обложкой. Модель планирует правку до рендера, и поэтому незатронутые части изображения остаются стабильными.
Текст поверх фото
Названия, строки выпуска и подписи накладываются на изображение в том написании, которое вы процитировали, и в том месте, которое вы указали.
До четырнадцати референсов
Объединяйте людей, продукты и обстановку из многих исходников, описывая в промпте роль каждого, в одном запросе на правку.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Опишите объект, обстановку, свет и объектив полными предложениями; слова в кавычках рисуются как текст на изображении. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От 1 до 14 исходных изображений. Напишите в промпте, что даёт каждое: человека, обстановку, продукт. Не менее 1 элементов · Не более 14 элементов |
aspect_ratio | Нет | auto (по умолчанию) сохраняет соотношение исходного изображения; либо выберите одно из десяти соотношений от 21:9 до 9:16. Соотношение сторон на цену не влияет. |
resolution | Нет | 1k (по умолчанию), 2k или 4k. 1k и 2k стоят одинаково; 4k стоит дороже и даёт 4096 пикселей по длинной стороне. |
official_fallback | Нет | По умолчанию включено. Каждая правка сначала выполняется по эконом-маршруту. По умолчанию: |
Стоимость
Оплата за изображение по уровню размера. Каждая правка сначала идёт по экономичному маршруту по экономичной цене, без платы за исходники. Если включён Official fallback (по умолчанию включён), правка, которую экономичный маршрут отклонил или не смог выполнить, а также правка с более чем 8 исходниками выполняется на официальном маршруте по официальной цене, где за каждый исходник добавляется небольшая фиксированная плата; выключите Official fallback, чтобы платить только экономичную цену. Расчёт стоимости показывает стартовую цену и максимум для правки. Отклонённые запросы не оплачиваются.
| Спецификация | Стоимость |
|---|---|
| $0.0668 / изображение (С Official fallback: до $0.1072) |
| $0.0668 / изображение (С Official fallback: до $0.1072) |
| $0.118 / изображение (С Official fallback: до $0.192) |
Сценарии использования
Превращение фото в обложки и постеры
Добавьте название, дату и строку текста к утверждённому фото без его ретуши.
Варианты настроения и света
Покажите клиенту, выбирающему направление, ту же сцену при свечах, на рассвете или в неоне.
Локализованные изображения кампании
Замените текст на готовом постере переведённой строкой для каждого рынка, оставив фото и его свет нетронутыми.
Руководство по промптам и практические советы
Меняйте по одной вещи за раз
Указания с одним изменением сохраняют стабильным всё остальное; стройте цепочку правок вместо того, чтобы сводить их в один промпт.
Защищайте людей
После изменения назовите человека, наряд и позу, которые должны остаться в точности прежними.
Закладывайте время на правки
У этой модели правки идут дольше, чем «текст в изображение»: в наших тестах на официальном маршруте в 2k — до трёх минут, а наши правки в 1k на экономичном маршруте укладывались меньше чем в минуту.
Цитируйте текст вместе с местом
Для добавляемого текста процитируйте каждую строку и укажите, где она стоит: сверху во всю ширину, в левом нижнем углу, рядом с логотипом.
Используйте 2k по умолчанию
У этой модели 1k и 2k стоят одинаково, так что редактируйте в 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-pro/edit",
"input": {
"aspect_ratio": "auto",
"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.
