NanoBanana Pro

Доступна

Флагманская модель изображений: высокая детализация, точное следование описанию, работа с референсами.


Идентификатор	`nanobanana-pro`
Метод	`POST /v1/images/generations`
Исходные изображения	до 7 (редактирование и референсы)

Цены

Разрешение	Стоимость
`1K`	20 ✦ за изображение
`2K`	20 ✦ за изображение
`4K`	25 ✦ за изображение

Параметры

Параметр	Тип	Описание
model*	string	`nanobanana-pro`
prompt*	string	Описание изображения, до 4000 символов. Можно на русском.
resolution	string	1K, 2K, 4K. По умолчанию `4K`.
aspect_ratio	string	Соотношение сторон, по умолчанию `auto` (по исходному изображению или модели). Допустимые значения зависят от разрешения — см. таблицу ниже.
images	string[]	До 7 id файлов из `POST /v1/files`.
callback_url	string	HTTPS-адрес для вебхука о завершении.
metadata	object	До 16 пар «ключ — строка», вернутся в задаче и вебхуке.
dry_run	boolean	Только проверить запрос и стоимость, без списания.

Соотношения сторон

Разрешение	aspect_ratio
`1K`	auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9
`2K`	auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9
`4K`	auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9

Пример: генерация по тексту

curl -s https://neuronovo.ru/api/v1/images/generations \
  -H "Authorization: Bearer $NEURONOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model":"nanobanana-pro","prompt":"Минималистичный постер: горы на рассвете, пастельные тона","resolution":"2K","aspect_ratio":"16:9"}'

Пример: редактирование изображения

Сначала загрузите файл методом POST /v1/files, затем передайте его id в поле images.

FILE_ID=$(curl -s https://neuronovo.ru/api/v1/files -H "Authorization: Bearer $NEURONOVO_API_KEY" -F "file=@product.jpg" | jq -r .id)

curl -s https://neuronovo.ru/api/v1/images/generations \
  -H "Authorization: Bearer $NEURONOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "nanobanana-pro", "prompt": "Сделай фон студийным белым, сохрани товар без изменений", "resolution": "2K", "images": [ "'"$FILE_ID"'" ] }'

Ответ

Код 202 и объект задачи. Результат — в result.files[0].url после статуса succeeded.

{
  "id": "cmg4k9x2a0003kz0f1n2m3p4q",
  "object": "task",
  "type": "image",
  "model": "nanobanana-pro",
  "status": "queued",
  "cost": { "credits": 20, "refunded": 0 },
  "result": null,
  "error": null,
  "queue": null
}