Текущий раздел: Nano Banana 2

Nano Banana 2

Создание и редактирование изображений по описанию и референсам

IDmodel-nano-banana-2POST/v1/generationsОриентирот 10 кредитов

Попробовать

Готовый запрос со значениями по умолчанию. Замените текст и ID файлов, оцените цену и запустите.

model-nano-banana-2

curl -X POST https://lumv.app/v1/generations \
  -H "Authorization: Bearer $LUMV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "model-nano-banana-2",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "auto",
    "image_resolution": "1K",
    "num_images": 1,
    "output_format": "png",
    "enable_web_search": false
  },
  "inputAssets": []
}'

Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.

Параметры

Передавайте значения в values, файлы — в inputAssets. Неизвестные параметры и null отклоняются.

Параметры9

promptstringобязательный
Что хотите создать? — Опишите сцену или изменения естественным языком.
По умолчанию
нет
Ограничения
до 50000 символов
image_urlsfile[] · inputAssetsнеобязательный
Референсы (необязательно) — Добавьте до 14 изображений, чтобы изменить их или сохранить стиль и композицию.
По умолчанию
нет
Ограничения
до 14 файлов · форматы: image/*
image_sizestring (размер)необязательный
Размер изображения — Выберите размер и соотношение сторон готового изображения.
По умолчанию
"auto"
Допустимые значения
- autoAUTO
- 1024x10241024 × 1024 (1:1) · квадрат
- 1024x7681024 × 768 (4:3) · альбом
- 1536x10241536 × 1024 (3:2) · альбом
- 1920x10801920 × 1080 (16:9) · Full HD
- 2560x14402560 × 1440 (16:9) · 2K
- 3840x21603840 × 2160 (16:9) · 4K
- 768x1024768 × 1024 (3:4) · портрет
- 1024x15361024 × 1536 (2:3) · портрет
- 1080x19201080 × 1920 (9:16) · Full HD
- 1440x25601440 × 2560 (9:16) · 2K
- 2160x38402160 × 3840 (9:16) · 4K
- 512x5121:1 · 0.5K
- 2048x20481:1 · 2K
- 4096x40961:1 · 4K
- 512x3844:3 · 0.5K
- 2048x15364:3 · 2K
- 4096x30724:3 · 4K
- 384x5123:4 · 0.5K
- 1536x20483:4 · 2K
- 3072x40963:4 · 4K
- 512x28816:9 · 0.5K
- 1024x57616:9 · 1K
- 2048x115216:9 · 2K
- 4096x230416:9 · 4K
- 288x5129:16 · 0.5K
- 576x10249:16 · 1K
- 1152x20489:16 · 2K
- 2304x40969:16 · 4K
- 344x5122:3 · 0.5K
- 680x10242:3 · 1K
- 1368x20482:3 · 2K
- 2728x40962:3 · 4K
- 512x3443:2 · 0.5K
- 1024x6803:2 · 1K
- 2048x13683:2 · 2K
- 4096x27283:2 · 4K
- 512x21621:9 · 0.5K
- 1024x44021:9 · 1K
- 2048x88021:9 · 2K
- 4096x175221:9 · 4K
- 408x5124:5 · 0.5K
- 816x10244:5 · 1K
- 1640x20484:5 · 2K
- 3280x40964:5 · 4K
- 512x4085:4 · 0.5K
- 1024x8165:4 · 1K
- 2048x16405:4 · 2K
- 4096x32805:4 · 4K
- 512x1284:1 · 0.5K
- 1024x2564:1 · 1K
- 2048x5124:1 · 2K
- 4096x10244:1 · 4K
- 128x5121:4 · 0.5K
- 256x10241:4 · 1K
- 512x20481:4 · 2K
- 1024x40961:4 · 4K
- 512x648:1 · 0.5K
- 1024x1288:1 · 1K
- 2048x2568:1 · 2K
- 4096x5128:1 · 4K
- 64x5121:8 · 0.5K
- 128x10241:8 · 1K
- 256x20481:8 · 2K
- 512x40961:8 · 4K
image_resolutionstring (enum)необязательный
Разрешение при AUTO — Определяет детализацию, когда точные размеры выбирает модель.
По умолчанию
"1K"
Ограничения
активно, когда image_size = "auto"
Допустимые значения
- 0.5K
- 1K
- 2K
- 4K
num_imagesnumberнеобязательный
Количество вариантов
По умолчанию
1
Ограничения
1–4
output_formatstring (enum)необязательный· расширенный
Формат файла
По умолчанию
"png"
Допустимые значения
- png
- jpeg
- webp
seednumberнеобязательный· расширенный
Seed — Для повторяемого результата.
По умолчанию
нет
enable_web_searchbooleanнеобязательный· расширенный
Использовать веб-поиск — Помогает модели учитывать актуальную информацию.
По умолчанию
false
thinking_levelstring (enum)необязательный· расширенный
Глубина рассуждения
По умолчанию
нет
Допустимые значения
- minimalМинимальная
- highВысокая

number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.

Сценарии

Сервер выбирает сценарий по values и файлам: при нескольких совпадениях — первый по порядку, сценарий без условия — запасной.

`scenario-0`передан файл image_urls

Активные поля: prompt, image_urls, image_size, image_resolution, num_images, output_format, seed, enable_web_search, thinking_level

scenario-0 · тело запроса

{
  "model": "model-nano-banana-2",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "auto",
    "image_resolution": "1K",
    "num_images": 1,
    "output_format": "png",
    "enable_web_search": false
  },
  "inputAssets": [
    {
      "fieldName": "image_urls",
      "assetId": "REPLACE_WITH_READY_ASSET_ID",
      "position": 0
    }
  ]
}

`scenario-1`по умолчанию

Активные поля: prompt, image_urls, image_size, image_resolution, num_images, output_format, seed, enable_web_search, thinking_level

scenario-1 · тело запроса

{
  "model": "model-nano-banana-2",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "auto",
    "image_resolution": "1K",
    "num_images": 1,
    "output_format": "png",
    "enable_web_search": false
  },
  "inputAssets": []
}

Цена и результат

Ориентир при стандартных настройках — 10 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.

Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.

Машиночитаемая схема: GET /v1/generation-models/model-nano-banana-2. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.

Nano Banana 2

Создание и редактирование изображений по описанию и референсам

IDmodel-nano-banana-2POST/v1/generationsОриентирот 10 кредитов

Попробовать

Готовый запрос со значениями по умолчанию. Замените текст и ID файлов, оцените цену и запустите.

model-nano-banana-2

curl -X POST https://lumv.app/v1/generations \
  -H "Authorization: Bearer $LUMV_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "model-nano-banana-2",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "auto",
    "image_resolution": "1K",
    "num_images": 1,
    "output_format": "png",
    "enable_web_search": false
  },
  "inputAssets": []
}'

Параметры

Передавайте значения в values, файлы — в inputAssets. Неизвестные параметры и null отклоняются.

Параметры9

promptstringобязательный
Что хотите создать? — Опишите сцену или изменения естественным языком.
По умолчанию
нет
Ограничения
до 50000 символов
image_urlsfile[] · inputAssetsнеобязательный
Референсы (необязательно) — Добавьте до 14 изображений, чтобы изменить их или сохранить стиль и композицию.
По умолчанию
нет
Ограничения
до 14 файлов · форматы: image/*
image_sizestring (размер)необязательный
Размер изображения — Выберите размер и соотношение сторон готового изображения.
По умолчанию
"auto"
Допустимые значения
- autoAUTO
- 1024x10241024 × 1024 (1:1) · квадрат
- 1024x7681024 × 768 (4:3) · альбом
- 1536x10241536 × 1024 (3:2) · альбом
- 1920x10801920 × 1080 (16:9) · Full HD
- 2560x14402560 × 1440 (16:9) · 2K
- 3840x21603840 × 2160 (16:9) · 4K
- 768x1024768 × 1024 (3:4) · портрет
- 1024x15361024 × 1536 (2:3) · портрет
- 1080x19201080 × 1920 (9:16) · Full HD
- 1440x25601440 × 2560 (9:16) · 2K
- 2160x38402160 × 3840 (9:16) · 4K
- 512x5121:1 · 0.5K
- 2048x20481:1 · 2K
- 4096x40961:1 · 4K
- 512x3844:3 · 0.5K
- 2048x15364:3 · 2K
- 4096x30724:3 · 4K
- 384x5123:4 · 0.5K
- 1536x20483:4 · 2K
- 3072x40963:4 · 4K
- 512x28816:9 · 0.5K
- 1024x57616:9 · 1K
- 2048x115216:9 · 2K
- 4096x230416:9 · 4K
- 288x5129:16 · 0.5K
- 576x10249:16 · 1K
- 1152x20489:16 · 2K
- 2304x40969:16 · 4K
- 344x5122:3 · 0.5K
- 680x10242:3 · 1K
- 1368x20482:3 · 2K
- 2728x40962:3 · 4K
- 512x3443:2 · 0.5K
- 1024x6803:2 · 1K
- 2048x13683:2 · 2K
- 4096x27283:2 · 4K
- 512x21621:9 · 0.5K
- 1024x44021:9 · 1K
- 2048x88021:9 · 2K
- 4096x175221:9 · 4K
- 408x5124:5 · 0.5K
- 816x10244:5 · 1K
- 1640x20484:5 · 2K
- 3280x40964:5 · 4K
- 512x4085:4 · 0.5K
- 1024x8165:4 · 1K
- 2048x16405:4 · 2K
- 4096x32805:4 · 4K
- 512x1284:1 · 0.5K
- 1024x2564:1 · 1K
- 2048x5124:1 · 2K
- 4096x10244:1 · 4K
- 128x5121:4 · 0.5K
- 256x10241:4 · 1K
- 512x20481:4 · 2K
- 1024x40961:4 · 4K
- 512x648:1 · 0.5K
- 1024x1288:1 · 1K
- 2048x2568:1 · 2K
- 4096x5128:1 · 4K
- 64x5121:8 · 0.5K
- 128x10241:8 · 1K
- 256x20481:8 · 2K
- 512x40961:8 · 4K
image_resolutionstring (enum)необязательный
Разрешение при AUTO — Определяет детализацию, когда точные размеры выбирает модель.
По умолчанию
"1K"
Ограничения
активно, когда image_size = "auto"
Допустимые значения
- 0.5K
- 1K
- 2K
- 4K
num_imagesnumberнеобязательный
Количество вариантов
По умолчанию
1
Ограничения
1–4
output_formatstring (enum)необязательный· расширенный
Формат файла
По умолчанию
"png"
Допустимые значения
- png
- jpeg
- webp
seednumberнеобязательный· расширенный
Seed — Для повторяемого результата.
По умолчанию
нет
enable_web_searchbooleanнеобязательный· расширенный
Использовать веб-поиск — Помогает модели учитывать актуальную информацию.
По умолчанию
false
thinking_levelstring (enum)необязательный· расширенный
Глубина рассуждения
По умолчанию
нет
Допустимые значения
- minimalМинимальная
- highВысокая

Сценарии

`scenario-0`передан файл image_urls

Активные поля: prompt, image_urls, image_size, image_resolution, num_images, output_format, seed, enable_web_search, thinking_level

scenario-0 · тело запроса

{
  "model": "model-nano-banana-2",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "auto",
    "image_resolution": "1K",
    "num_images": 1,
    "output_format": "png",
    "enable_web_search": false
  },
  "inputAssets": [
    {
      "fieldName": "image_urls",
      "assetId": "REPLACE_WITH_READY_ASSET_ID",
      "position": 0
    }
  ]
}

`scenario-1`по умолчанию

Активные поля: prompt, image_urls, image_size, image_resolution, num_images, output_format, seed, enable_web_search, thinking_level

scenario-1 · тело запроса

{
  "model": "model-nano-banana-2",
  "values": {
    "prompt": "Describe the desired result",
    "image_size": "auto",
    "image_resolution": "1K",
    "num_images": 1,
    "output_format": "png",
    "enable_web_search": false
  },
  "inputAssets": []
}

Попробовать

Параметры

Сценарии

scenario-0передан файл image_urls

scenario-1по умолчанию

Цена и результат

Попробовать

Параметры

Сценарии

scenario-0передан файл image_urls

scenario-1по умолчанию

Цена и результат

`scenario-0`передан файл image_urls

`scenario-1`по умолчанию

`scenario-0`передан файл image_urls

`scenario-1`по умолчанию