Nano Banana Pro

Nano Banana Pro (google/gemini-3-pro-image-preview) — топ-модель Google для фотореалистичных изображений вплоть до 4K. Два эндпоинта: POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для работы по картинке-образцу. Модель платная — генерации списываются с баланса, бесплатной квоты для неё нет.

Параметры

Поле	Описание
`model`	`google/gemini-3-pro-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-pro-image-preview",
    prompt="Портрет ювелира за работой, мягкий боковой свет, малая глубина резкости",
    extra_body={"aspect_ratio": "4:5", "resolution": "2k"},
)
with open("jeweler.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-pro-image-preview",
    "prompt": "Портрет ювелира за работой, мягкий боковой свет, малая глубина резкости",
    "aspect_ratio": "4:5",
    "resolution": "2k"
  }'

Картинка в 4K под обложку

{
  "model": "google/gemini-3-pro-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-pro-image-preview \
  -F image=@portrait.png \
  -F prompt="Замени фон на вечерний город, лицо и свет не трогай"

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

Цена

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

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

Фотореалистичные изображения — основной профиль модели, 4K как верхняя ступень.
Десять форматов кадра: от квадрата 1:1 до панорамного 21:9, в трёх разрешениях.
Редактирование по образцу: перенос стиля и точечные правки через /v1/images/edits.
Работает только с баланса — в бесплатную квоту не входит.
Ручки quality нет; размер вне таблицы модели вернёт 400.
При переносе стиля модель наследует от образца цветовую гамму — другой колорит описывайте в промпте явно.

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