ГлавнаяМоделиГенерация изображенийNano Banana 2

Nano Banana 2

ПровайдерGoogle

nano-banana-2 — генерация изображений-модель от Google.

high_qualityimage_to_imagetext_to_image

Что умеет Nano Banana 2

  • Высокое качество
  • Image-to-Image
  • Text-to-image

Стоимость

за изображение
512
13.04 ₽
1K
19.31 ₽
2K
28.71 ₽
4K
42.83 ₽

Цены указаны в рублях и списываются с баланса проекта за успешные запросы. Надбавки (+) суммируются с базовой ставкой.

Технические характеристики

Vendor
google
Modality
image

Параметры запроса

Параметры, которые принимает модель. Передаются в теле запроса.

ПараметрТипДиапазон / значенияПо умолчаниюОписание
positivePromptreq
string
min: 3 · max: 45000
—
Текстовый промпт — до 45k символов. Можно передавать длинные сценарии, multi-image инструкции, character briefs.
1 пример
Примеры
Создай 2x2 grid с одним и тем же персонажем в 4 разных нарядах: casual, sport, formal, evening.
width
integer
—
—
Ширина в px. Парный к height — только валидные комбинации (см. ниже). Несовместимо с resolution.
height
integer
—
—
Высота в px. Парный к width. Список валидных значений — см. combos у width.
resolution
enum
0.5K, 1K, 2K, 4K
—
Resolution preset. Несовместимо с width/height. При inputs.referenceImages aspect ratio наследуется.
seed
integer
min: 0 · max: 9223372036854776000
—
Seed для воспроизводимой генерации. Если не указан — выбирается случайно.
inputs.referenceImages
array of strings
min: 1 · max: 14
—
Reference-изображения (UUID / URL / Data URI / Base64). До 14 шт. Каждый референс +$0.00028 к стоимости.
1 пример
Примеры
[
  "https://example.com/ref1.jpg",
  "https://example.com/ref2.jpg"
]
settings.systemPrompt
string
min: 1 · max: 50000
—
Системная инструкция для модели (до 50k chars). Задаёт глобальное поведение и стиль.
settings.temperature
number
min: 0 · max: 1
—
Случайность генерации (шаг 0.01). 0 = детерминированная генерация, 1 = максимально случайная.
settings.topP
number
min: 0 · max: 1
—
Nucleus sampling (шаг 0.01). Альтернатива temperature.
settings.thinking
enum
MINIMAL, HIGH
—
Глубина обдумывания модели перед генерацией. MINIMAL — быстро, HIGH — глубже и медленнее.
providerSettings.google.safetyTolerance
enum
high, medium, low, none, off
none
Уровень safety-фильтра Google: high — самый строгий, off — отключено.
providerSettings.google.imageSearch
boolean
—
false
Включить grounded image search — модель ищет references в вебе. ДОБАВЛЯЕТ $0.14 к стоимости запроса.
providerSettings.google.webSearch
boolean
—
false
Включить live web search — модель может искать актуальную информацию для генерации. ДОБАВЛЯЕТ $0.14 к стоимости запроса.
numberResults
integer
min: 1 · max: 20
1
Сколько вариаций сгенерировать. Для image — до 20 за один запрос.
outputType
enum
URL, base64Data, dataURI
URL
Формат доставки: URL — CDN-ссылка (default), base64Data — raw base64, dataURI — data:image/...;base64,...
outputFormat
enum
JPG, PNG, WEBP
JPG
Формат изображения.
outputQuality
integer
min: 20 · max: 99
95
Качество компрессии (20–99).
async
boolean
—
false
true → task_id для async-polling. false (default) → sync.
safety.checkContent
boolean
—
false
Включить проверку контента (Runware-уровень). Отдельно от providerSettings.google.safetyTolerance.
safety.mode
enum
none, fast
none
Режим safety-сканера.
webhookURL
string
—
—
URL для POST-уведомления при готовности async-задачи.
1 пример
Примеры
https://yourapp.com/webhooks/runware
uploadEndpoint
string
—
—
Presigned URL для автозагрузки готового изображения.
1 пример
Примеры
https://bucket.s3.amazonaws.com/result.png?X-Amz-Signature=...

Поддерживаемые размеры

Допустимы только эти комбинации width × height. Произвольные значения вендор отклонит — используй resolution preset либо одну из пар ниже.

0.5K (1:1)
512×512
0.5K (3:2)
632×424
0.5K (2:3)
424×632
0.5K (4:3)
600×448
0.5K (3:4)
448×600
0.5K (4:5)
464×576
0.5K (5:4)
576×464
0.5K (9:16)
384×688
0.5K (16:9)
688×384
0.5K (21:9)
792×168
0.5K (4:1)
1024×256
0.5K (1:4)
256×1024
0.5K (8:1)
1536×192
0.5K (1:8)
192×1536
1K (1:1)
1024×1024
1K (3:2)
1264×848
1K (2:3)
848×1264
1K (4:3)
1200×896
1K (3:4)
896×1200
1K (4:5)
928×1152
1K (5:4)
1152×928
1K (9:16)
768×1376
1K (16:9)
1376×768
1K (21:9)
1584×672
1K (4:1)
2048×512
1K (1:4)
512×2048
1K (8:1)
3072×384
1K (1:8)
384×3072
2K (1:1)
2048×2048
2K (3:2)
2528×1696
2K (2:3)
1696×2528
2K (4:3)
2400×1792
2K (3:4)
1792×2400
2K (4:5)
1856×2304
2K (5:4)
2304×1856
2K (9:16)
1536×2752
2K (16:9)
2752×1536
2K (21:9)
3168×1344
2K (4:1)
4096×1024
2K (1:4)
1024×4096
2K (8:1)
6144×768
2K (1:8)
768×6144
4K (1:1)
4096×4096
4K (3:2)
5056×3392
4K (2:3)
3392×5056
4K (4:3)
4800×3584
4K (3:4)
3584×4800
4K (4:5)
3712×4608
4K (5:4)
4608×3712
4K (9:16)
3072×5504
4K (16:9)
5504×3072
4K (21:9)
6336×2688
4K (4:1)
8192×2048
4K (1:4)
2048×8192
4K (8:1)
12288×1536
4K (1:8)
1536×12288

Параметры ответа

Что возвращает API. У медиа-моделей формат зависит от режима: sync — сразу результат, async — task_id для опроса через GET /v1/tasks/{id}.

Sync (HTTP 200)

Sync-ответ (default). HTTP 200 + JSON.

ПолеТипЗначенияОписание
created
integer
—
Unix timestamp когда сгенерировано.
data
array
—
Каждый элемент:
  • url— string · CDN URL картинки (если outputType=URL).
  • b64_json— string · Base64-кодированный PNG/JPG (если outputType=base64Data).
  • taskUUID— string · Идентификатор upstream-задачи (для chain в i2i и т.п.).
  • seed— integer · Использованный seed (если детерминистичная генерация).
provider
string
—
Вендор для отладки.

Async (HTTP 202)

Если в запросе передан async:true → HTTP 202.

ПолеТипЗначенияОписание
id
string
—
task_id для опроса через GET /v1/tasks/{id}.
object
string
image.task
status
enum
queued, processing, completed, failed
model
string
—
Public model id.
created
integer
—

Опрос статуса (GET /v1/tasks/{id})

GET /v1/tasks/{id} — опрос статуса async-задачи.

ПолеТипЗначенияОписание
id
string
—
object
string
task
status
enum
queued, processing, completed, failed, canceled
modality
string
image
model
string
—
created
integer
—
data
array
—
Каждый элемент:
  • url— string · CDN URL артефакта (если completed).
error
string
—
Сообщение об ошибке (если failed).

Пример кода

nano-banana-2_example.py
from openai import OpenAI

client = OpenAI(api_key="rk_live_...", base_url="https://api.ranvik.ru/v1")
resp = client.images.generate(
    model= "nano-banana-2",
    positivePrompt= "Пример промпта",
    width= 1,
    height= 1,
    resolution= "0.5K",
    seed= 4611686018427388000,
    "inputs.referenceImages": [],
    "settings.systemPrompt": "Пример промпта",
    "settings.temperature": 0.5,
    "settings.topP": 0.5,
    "settings.thinking": "MINIMAL",
    "providerSettings.google.safetyTolerance": "none",
    "providerSettings.google.imageSearch": False,
    "providerSettings.google.webSearch": False,
    numberResults= 1,
    outputType= "URL",
    outputFormat= "JPG",
    outputQuality= 95,
    async= False,
    "safety.checkContent": False,
    "safety.mode": "none",
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
)
print(resp)
Полная документация модели