Справочник API для генерации/редактирования изображений

Справочник интерфейсов серии Nano Banana (модели изображений экосистемы Gemini). Введение в серию и советы по промптам см. Генерация изображений Nano Banana.

Генерация изображений по тексту

POST https://api.4allapi.com/v1/images/generations

curl https://api.4allapi.com/v1/images/generations \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image-portrait",
    "prompt": "Портрет в стиле обложки журнала, естественный свет, малая глубина резкости, в нижней части кадра написано \"OMNI\""
  }'

Соотношение сторон и разрешение задаются суффиксом модели: -square / -portrait / -landscape / -three-four / -four-three, для высокого разрешения добавьте -2k;
У Gemini хорошо работаетрендеринг текста на изображении; текстовое содержимое пишите в промпте в кавычках.

Редактирование изображения (image-to-image)

POST https://api.4allapi.com/v1/images/edits

curl https://api.4allapi.com/v1/images/edits \
  -H "Authorization: Bearer $AIPROXY_KEY" \
  -F model="gemini-3.1-flash-image" \
  -F image="@ref.png" \
  -F prompt="Тот же человек, но в зимнем снежном пейзаже, во весь рост, сохранив неизменными черты лица"

Несколько референсных изображений передавайте в виде нескольких полей image по порядку; в промпте опишите роль каждого изображения (основное изображение / изображение стиля);
Для сценариев с сохранением идентичности человека/товара в первую очередь используйте интерфейс редактирования, а не повторную генерацию по тексту.

Уровни моделей

Уровень	Представительная модель	Особенности
Pro	серия `gemini-3.0-pro-image`	Наивысшее качество, лучшие детали и текст
Стандарт	серия `gemini-3.1-flash-image`	Баланс качества и скорости, основной уровень
Предпросмотр	`gemini-3-pro-image`	Ранний доступ к новым возможностям

Актуальные модели в продаже и цены см. в витрине моделей; структура ответа и замечания по сохранению см. в Справочнике API генерации изображений.