Nano Banana 2

Nano Banana 2 (google/gemini-3.1-flash-image-preview) — обновлённая Nano Banana с улучшенной детализацией. Два эндпоинта: POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для работы по картинке-образцу. Модель платная — генерации списываются с баланса, бесплатной квоты для неё нет.

Параметры

Поле	Описание
`model`	`google/gemini-3.1-flash-image-preview` (или короткое `gemini-3.1-flash-image-preview`)
`prompt`	Описание изображения, обязательное
`n`	Сколько картинок, от 1 до 4; каждая тарифицируется отдельно
`aspect_ratio`	`1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`; по умолчанию `1:1`
`resolution`	`1k`, `2k` или `4k`; по умолчанию `1k`
`size`	Явный размер `WxH` — альтернатива паре `aspect_ratio` + `resolution`
`quality`	У модели нет такой ручки: передача параметра вернёт `400`

Модель мыслит парой «формат + разрешение», а WxH — производное от них. Соответствия для ходовых комбинаций:

Формат	1k	2k	4k
`1:1`	`1000x1000`	`2000x2000`	`2828x2828`
`16:9`	`1332x750`	`2666x1500`	`3770x2120`
`9:16`	`750x1332`	`1500x2666`	`2120x3770`

Полный список из 30 допустимых size — поле sizes в каталоге; значение вне списка вернёт 400.

Примеры

import base64

img = client.images.generate(
    model="google/gemini-3.1-flash-image-preview",
    prompt="Портрет бариста за помолом кофе, тёплый контровой свет, малая глубина резкости",
    extra_body={"aspect_ratio": "4:5", "resolution": "2k"},
)
with open("barista.png", "wb") as f:
    f.write(base64.b64decode(img.data[0].b64_json))

curl https://api.mixen.ai/v1/images/generations \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-3.1-flash-image-preview",
    "prompt": "Портрет бариста за помолом кофе, тёплый контровой свет, малая глубина резкости",
    "aspect_ratio": "4:5",
    "resolution": "2k"
  }'

Панорама в 4K

{
  "model": "google/gemini-3.1-flash-image-preview",
  "prompt": "Ночной город с высоты: огни кварталов, длинная выдержка, фотореализм",
  "aspect_ratio": "21:9",
  "resolution": "4k"
}

Редактирование по образцу

Модель принимает картинки-образцы (references: true), поэтому доступен /v1/images/edits с multipart/form-data:

curl https://api.mixen.ai/v1/images/edits \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -F model=google/gemini-3.1-flash-image-preview \
  -F image=@portrait.png \
  -F prompt="Замени фон на янтарный закат, лицо и свет не трогай"

Ответ всегда содержит b64_json — файлы не хостятся. Оба эндпоинта отвечают синхронно; ставьте таймаут HTTP-клиента не меньше 120 секунд.

Цена

5.3477 ₽ ($0.06) за изображение — единая витринная цена из каталога. Актуальные значения — каталог.

Сильные стороны и ограничения

Улучшенная детализация относительно первой Nano Banana — обновлённое поколение модели.
Десять форматов кадра: от квадрата 1:1 до панорамного 21:9, в трёх разрешениях до 4K.
Тридцать фиксированных size — по одному на каждую пару «формат + разрешение».
Редактирование по образцу через /v1/images/edits — тот же ключ и тот же синтаксис, что у генерации.
Nano Banana 2 Lite (google/gemini-3.1-flash-lite-image-preview) — самая быстрая и экономичная image-модель Google: тот же набор форматов и разрешений за 3.3423 ₽ ($0.0375).
Работает только с баланса; ручки quality нет — размер вне таблицы модели вернёт 400.

Все модели — в каталоге. Общий порядок работы с изображениями — гайд по изображениям.