Nano Banana Pro
model-nano-banana-proPOST/v1/generationsОриентирот 17,85 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#promptstringобязательныйЧто нужно создать? — Опишите сюжет, композицию, стиль и важные детали.
- По умолчанию
- нет
- Ограничения
- до 5000 символов
image_urlsfile[] · inputAssetsнеобязательныйИзображения для редактирования — Необязательно: до 14 изображений-референсов.
- По умолчанию
- нет
- Ограничения
- до 14 файлов · форматы: image/*
image_sizestring (размер)необязательныйРазмер изображения — Выберите размер и соотношение сторон готового изображения.
- По умолчанию
"auto"
Допустимые значения
autoAUTO1024x10241024 × 1024 (1:1) · квадрат1024x7681024 × 768 (4:3) · альбом1536x10241536 × 1024 (3:2) · альбом1920x10801920 × 1080 (16:9) · Full HD2560x14402560 × 1440 (16:9) · 2K3840x21603840 × 2160 (16:9) · 4K768x1024768 × 1024 (3:4) · портрет1024x15361024 × 1536 (2:3) · портрет1080x19201080 × 1920 (9:16) · Full HD1440x25601440 × 2560 (9:16) · 2K2160x38402160 × 3840 (9:16) · 4K2048x20481:1 · 2K4096x40961:1 · 4K2048x15364:3 · 2K4096x30724:3 · 4K1536x20483:4 · 2K3072x40963:4 · 4K1024x57616:9 · 1K2048x115216:9 · 2K4096x230416:9 · 4K576x10249:16 · 1K1152x20489:16 · 2K2304x40969:16 · 4K680x10242:3 · 1K1368x20482:3 · 2K2728x40962:3 · 4K1024x6803:2 · 1K2048x13683:2 · 2K4096x27283:2 · 4K1024x44021:9 · 1K2048x88021:9 · 2K4096x175221:9 · 4K816x10244:5 · 1K1640x20484:5 · 2K3280x40964:5 · 4K1024x8165:4 · 1K2048x16405:4 · 2K4096x32805:4 · 4K
image_resolutionstring (enum)необязательныйРазрешение при AUTO — Определяет детализацию, когда точные размеры выбирает модель.
- По умолчанию
"1K"- Ограничения
- активно, когда image_size = "auto"
Допустимые значения
1K2K4K
enable_web_searchbooleanнеобязательныйИспользовать веб-поиск
- По умолчанию
false
output_formatstring (enum)необязательный· расширенныйФормат файла
- По умолчанию
"png"
Допустимые значения
pngPNGjpegJPEG
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0передан файл image_urls
Активные поля: prompt, image_urls, image_size, image_resolution, enable_web_search, output_format
{
"model": "model-nano-banana-pro",
"values": {
"prompt": "Describe the desired result",
"image_size": "auto",
"image_resolution": "1K",
"enable_web_search": false,
"output_format": "png"
},
"inputAssets": [
{
"fieldName": "image_urls",
"assetId": "REPLACE_WITH_READY_ASSET_ID",
"position": 0
}
]
}scenario-1по умолчанию
Активные поля: prompt, image_urls, image_size, image_resolution, enable_web_search, output_format
{
"model": "model-nano-banana-pro",
"values": {
"prompt": "Describe the desired result",
"image_size": "auto",
"image_resolution": "1K",
"enable_web_search": false,
"output_format": "png"
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 17,85 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через 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-pro. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.