Введение
Передайте пронумерованные изображения и инструкцию с нужными изменениями и деталями для сохранения.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Издатель и обозначение | Google; Gemini 3.1 Flash Lite Image |
| Рабочие сценарии | Генерация по тексту и редактирование изображений |
| Выходной уровень | 1K; около миллиона пикселей |
| Вместимость промпта | До 20 000 символов |
| Фиксированные формы | 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 |
| Исходная форма генерации | 1:1 |
| Дополнительная форма правки | auto помимо четырнадцати фиксированных пропорций |
| Источники редактирования | От 1 до 10 картинок; обозначения Image 1, Image 2 и далее |
| Принцип тарифа | Фиксированная цена за изображение; ошибки бесплатны |
| Фильтр содержания | Издатель применяет собственный фильтр; отмеченные запросы отклоняются без оплаты |
| Хранение результатов | 14 дней, затем генерации удаляются |
Ключевые возможности и особенности
Та же пара, разные позы
Генерация 1:4 дала четыре чёрно-белых кадра фотобудки: смех, поцелуй, игривое потягивание галстука и соприкосновение лбами. Пара оставалась согласованной. Задайте порядок и узкую форму настройкой; это одна картинка с четырьмя кадрами, а не обещание для любых героев и макетов.
Уголок чтения в вагоне
Пример поезда начинается с места и контраста: уют внутри, дождь снаружи. Наш тест создал вагонный уголок. Конкретная мебель и свет объясняют сцену; пропорции должны оставить место окну и сиденью. 1K подходит оценке композиции до решения о более крупной версии.
Зимний свет вокруг зелёных растений
В тесте солнечная оранжерея стала зимним утром. На стекле иней, свет холодный, растения внутри зелёные. Сравните стекло и свет, затем растения отдельно. Назовите оранжерею Image 1 и явно задайте сезон и сохраняемое.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите нужную правку в пределах 20 000 символов, обращаясь к исходникам как Image 1, Image 2 и далее; объём текста не влияет на фиксированный тариф. Не менее 1 символов · Не более 20000 символов |
image_urls | Да | Передайте 1–10 URL исходных изображений для правки; в этом режиме оплачивается созданное изображение, а не число исходников. Не менее 1 элементов · Не более 10 элементов |
aspect_ratio | Нет | Выберите auto для формы исходника либо 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8 или 8:1; форма не меняет цену Lite. |
Стоимость
$0.027 / изображение
При редактировании Lite действует фиксированная цена за созданное изображение независимо от пропорций и числа исходников; неудачные правки не оплачиваются.
Сценарии использования
История в фотополосе
Разместите пару в четырёх моментах узкой композиции 1:4. Наш чёрно-белый результат сохранил узнаваемость пары при смене поз.
Этюд настроения интерьера
Исследуйте тёплый свет рядом с дождём до разработки комнаты. Тест вагона поместил уголок чтения в такую обстановку.
Сезонная правка места
Попросите зиму, назвав сохраняемые детали внутри. В оранжерее появились иней и холодный свет, растения остались зелёными.
Холст необычного размещения
Выберите 1:8, 8:1 или другие поддерживаемые формы для узкого или панорамного макета. Они меняют композицию без большего разрешения.
Задание с номерами референсов
Используйте от одного до десяти источников для готового визуального материала. Объясните вклад каждого и сверяйте детали с ними.
Руководство по промптам и практические советы
Выберите отправную точку
Откройте генерацию по тексту для описанной сцены или правку для готовой картинки. Для людей нужны совершеннолетние и разрешённые фото без имитации личности.
Дайте сцене направление
Назовите место, свет и видимое действие. При правке свяжите входы с Image 1, Image 2 и далее, отделив изменения от сохраняемого.
Выберите пропорции холста
Для генерации задайте фиксированную форму, например 1:4 для вертикальной фотополосы. В правке auto следует исходнику; любой выбор остаётся 1K.
Оцените и скачайте
До принятия сравните лица, предметы и кадрирование с заданием. Сохраните файл за 14 дней вместе с промптом и настройками.
Правка картинки по письменному заданию
Nano Banana 2 Lite image to image принимает готовый визуальный материал и prompt изменения. Передайте одну–десять картинок, назовите номера, изменения и сохраняемое. Выход остаётся 1K, около миллиона пикселей. Подходит точечному этюду места или света с исходными деталями для переноса.
Оранжерея показывает сезонный запрос: солнечное место стало зимним утром с инеем и холодным светом, растения остались зелёными. Это наблюдение правки, а не гарантия идентичности каждой области вне задания.
Параметры изменения
| Параметр | Вход | Применение |
|---|---|---|
| prompt | До 20 000 символов | Номера источников, изменения и сохранение |
image_urls | От одного до десяти URL | Image 1, Image 2 и далее соответствуют порядку |
aspect_ratio | auto либо 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8 или 8:1 | auto следует источнику, иначе фиксированный холст |
Правка добавляет auto к четырнадцати формам генерации. Выбирайте его осознанно для пропорций источника. При нескольких входах не предполагается одинаковая форма всех референсов; для конкретного размещения задайте фиксированную. Ни один выбор не увеличивает выходной уровень.
Понятные роли референсов
Цель каждого входа
Номер показывает редактору, куда смотреть. Начните с «Используй оранжерею в Image 1», затем зимняя атмосфера. Для добавочных назовите вклад Image 2 и следующих. До отправки сверьте с image_urls.
До десяти входов — вместимость, а не обещание стабильности сложного набора. По данным Google, Lite не оптимизирована для нескольких референсов или последовательных многошаговых правок. Оранжерея касается точечной смены сезона, не надёжности длинной цепочки.
Изменение отдельно от сохранения
Пишите раздельно: «Добавь иней на стекло и охлади дневной свет. Оставь растения зелёными». Контраст ясен. Для своей сцены назовите важные структуры и предметы, затем сравните с оригиналом.
Образец подтверждает иней, холодный свет и зелень. Можно попросить сохранить дорожку и посадки, но проверяйте: просьба сохранения не равна измеренному результату. Тратьте текст на видимое вместо повторов общей просьбы качества.
Разрешение на портреты
Используйте разрешённые фотографии совершеннолетних без имитации личности. В новом задании укажите возраст от тридцати лет, одежду, выражение, свет и место. Чётко задайте личность и сравните лицо с разрешённым источником до использования.
Для этюда света: «Используй разрешённый портрет женщины сорока с лишним лет из Image 1; добавь тёплый студийный свет на синем фоне; сохрани тёмно-синий жакет и сидячую позу». Это предлагаемый шаблон без проверенного портретного результата.
Сверка с источником
Практический порядок на примере оранжереи:
- Сравните стекло и дневной свет для нужного сезона.
- Проверьте сохранённую зелень внутри.
- Оцените композицию и окружение до принятия.
- Храните источник, инструкцию, пропорции и принятый выход вместе.
Для следующей правки прямо назовите остаточную проблему. Точечное продолжение легче оценить, чем одновременную смену сезона, мебели, камеры и стиля. Наши заметки не измеряют длинные истории правок и сроки.
Оплата и эксплуатационные пределы
За созданную картинку фиксированная цена независимо от пропорций; ошибки не оплачиваются. Текущая сумма — на странице модели; для сметы смотрите её, а не скопированное руководство.
Издатель применяет собственный фильтр; отмеченное отклоняется без платы. Для правок действуют те же границы принятия, что для новых картинок. Файлы хранятся 14 дней до удаления: скачивайте принятое и держите оригиналы в проекте.
Когда нужен другой эндпоинт
Для новой композиции без картинок используйте Lite text to image. Фотополоса показывает четырёхкадровый макет, а здесь исходны референсы. Если нужен 2K или 4K, Nano Banana 2.1 имеет эти уровни; Lite остаётся более дешёвой 1K. Выбирайте по материалу, размеру и проверяемым деталям.
Быстрый старт 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-lite/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"
}
}'
# 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.







