Генерация изображений · google

Nano Banana 2.1

nano-banana-2-1

Nano Banana 2.1 — генерация изображений от Google, доступная через единый Ranvik API. Поддерживаемые возможности: image_to_image, web_search.

от 200 ₽ / 1 млн входных токенов

Nano Banana 2.1

Создает изображения по тексту и редактирует их с учетом до 14 референсов. Поддерживает 42 точных размера в трех уровнях: 1K, 2K и 4K. Настройки передаются внутри settings, референсы — внутри inputs.

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

МодальностьГенерация изображений
Провайдерgoogle
СтатусАктивна
ID для запросовnano-banana-2-1

Возможности

  • Редактирование изображений
  • Поиск в интернете

Цены

ЕдиницаЦена
за 1 млн входных текстовых токенов · Входные токены200 ₽
за 1 млн выходных текстовых токенов · Текстовые выходные токены998 ₽
за 1 млн выходных токенов изображения · Выходные токены изображения3 990 ₽
за изображение · Ориентировочно 1K4.94 ₽
за изображение · Ориентировочно 1K · 1024x10244.94 ₽
за изображение · Ориентировочно 1K · 1264x8484.94 ₽
за изображение · Ориентировочно 1K · 848x12644.94 ₽
за изображение · Ориентировочно 1K · 1200x8964.94 ₽
за изображение · Ориентировочно 1K · 896x12004.94 ₽
за изображение · Ориентировочно 1K · 928x11524.94 ₽
за изображение · Ориентировочно 1K · 1152x9284.94 ₽
за изображение · Ориентировочно 1K · 768x13764.94 ₽
за изображение · Ориентировочно 1K · 1376x7684.94 ₽
за изображение · Ориентировочно 1K · 1584x6724.94 ₽
за изображение · Ориентировочно 1K · 2048x5124.94 ₽
за изображение · Ориентировочно 1K · 512x20484.94 ₽
за изображение · Ориентировочно 1K · 3072x3844.94 ₽
за изображение · Ориентировочно 1K · 384x30724.94 ₽
за изображение · Ориентировочно 1K4.94 ₽
за запрос · Ориентировочная надбавка за референсы5.32 ₽
за изображение · Ориентировочно 2K · 2048x20487.41 ₽
за изображение · Ориентировочно 2K · 2528x16967.41 ₽
за изображение · Ориентировочно 2K · 1696x25287.41 ₽
за изображение · Ориентировочно 2K · 2400x17927.41 ₽
за изображение · Ориентировочно 2K · 1792x24007.41 ₽
за изображение · Ориентировочно 2K · 1856x23047.41 ₽
за изображение · Ориентировочно 2K · 2304x18567.41 ₽
за изображение · Ориентировочно 2K · 1536x27527.41 ₽
за изображение · Ориентировочно 2K · 2752x15367.41 ₽
за изображение · Ориентировочно 2K · 3168x13447.41 ₽
за изображение · Ориентировочно 2K · 4096x10247.41 ₽
за изображение · Ориентировочно 2K · 1024x40967.41 ₽
за изображение · Ориентировочно 2K · 6144x7687.41 ₽
за изображение · Ориентировочно 2K · 768x61447.41 ₽
за изображение · Ориентировочно 2K7.41 ₽
за изображение · Ориентировочно 4K · 4096x409617.29 ₽
за изображение · Ориентировочно 4K · 5056x339217.29 ₽
за изображение · Ориентировочно 4K · 3392x505617.29 ₽
за изображение · Ориентировочно 4K · 4800x358417.29 ₽
за изображение · Ориентировочно 4K · 3584x480017.29 ₽
за изображение · Ориентировочно 4K · 3712x460817.29 ₽
за изображение · Ориентировочно 4K · 4608x371217.29 ₽
за изображение · Ориентировочно 4K · 3072x550417.29 ₽
за изображение · Ориентировочно 4K · 5504x307217.29 ₽
за изображение · Ориентировочно 4K · 6336x268817.29 ₽
за изображение · Ориентировочно 4K · 8192x204817.29 ₽
за изображение · Ориентировочно 4K · 2048x819217.29 ₽
за изображение · Ориентировочно 4K · 12288x153617.29 ₽
за изображение · Ориентировочно 4K · 1536x1228817.29 ₽
за изображение · Ориентировочно 4K17.29 ₽

Цены указаны в рублях. Списываются с баланса проекта при каждом успешном запросе.

Поддерживаемые параметры

Параметры передаются вендору как есть (pure proxy) — мы не валидируем их у себя на стороне. Если вендор не примет — вернётся его ошибка.

ПараметрТипДиапазон / valuesDefaultОписание
positivePromptrequiredstringmin: 3 · max: 45000— Описание изображения или требуемых изменений.
примеры значений
Примеры
Красный куб на белом фоне.
widthinteger—— Ширина в пикселях: строго одна из 42 пар с height. Вместе с resolution не используется.
heightinteger—— Высота в пикселях. Требуется вместе с width. Несовместима с resolution.
resolutionenum1K, 2K, 4K— Автоматический формат по референсам: требует inputs.referenceImages, несовместим с width/height.
inputs.referenceImagesarray of stringsmin: 1 · max: 14— Референсы и изображения для редактирования: URL, UUID или data URI.
примеры значений
Примеры
[
  "https://example.com/reference.png"
]
inputs.referenceVideosarray of stringsmin: 1 · max: 1— Один референс-видеофайл.
seedintegermin: 0 · max: 2147483647— Начальное значение генератора; 0 является допустимым значением.
settings.systemPromptstringmin: 1 · max: 50000— Системные инструкции для генерации.
settings.temperaturenumbermin: 0 · max: 2— Вариативность результата.
settings.topPnumbermin: 0 · max: 1— Порог вероятностной выборки.
settings.thinkingLevelenumminimal, medium, highmedium Уровень рассуждений.
settings.webSearchboolean—false Использовать поиск в интернете.
settings.imageSearchboolean—false Использовать поиск изображений.
settings.safetyToleranceenumhigh, medium, low, none, offnone Уровень фильтрации контента.
numberResultsintegermin: 1 · max: 41 Количество результатов.
outputTypeenumURL, base64Data, dataURIURL Способ возврата изображения.
outputFormatenumPNG, JPG, WEBPPNG Формат выходного изображения.
outputQualityintegermin: 20 · max: 9995 Качество компрессии изображения.
safety.checkContentboolean—false Дополнительная проверка безопасности результата.
safety.modeenumnone, fast, fullnone Режим дополнительной проверки.
webhookURLstring—— URL для уведомления провайдера о готовности.
uploadEndpointstring—— Presigned URL для загрузки результата.

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

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

1K · 1024x1024
1024×1024
1K · 1264x848
1264×848
1K · 848x1264
848×1264
1K · 1200x896
1200×896
1K · 896x1200
896×1200
1K · 928x1152
928×1152
1K · 1152x928
1152×928
1K · 768x1376
768×1376
1K · 1376x768
1376×768
1K · 1584x672
1584×672
1K · 2048x512
2048×512
1K · 512x2048
512×2048
1K · 3072x384
3072×384
1K · 384x3072
384×3072
2K · 2048x2048
2048×2048
2K · 2528x1696
2528×1696
2K · 1696x2528
1696×2528
2K · 2400x1792
2400×1792
2K · 1792x2400
1792×2400
2K · 1856x2304
1856×2304
2K · 2304x1856
2304×1856
2K · 1536x2752
1536×2752
2K · 2752x1536
2752×1536
2K · 3168x1344
3168×1344
2K · 4096x1024
4096×1024
2K · 1024x4096
1024×4096
2K · 6144x768
6144×768
2K · 768x6144
768×6144
4K · 4096x4096
4096×4096
4K · 5056x3392
5056×3392
4K · 3392x5056
3392×5056
4K · 4800x3584
4800×3584
4K · 3584x4800
3584×4800
4K · 3712x4608
3712×4608
4K · 4608x3712
4608×3712
4K · 3072x5504
3072×5504
4K · 5504x3072
5504×3072
4K · 6336x2688
6336×2688
4K · 8192x2048
8192×2048
4K · 2048x8192
2048×8192
4K · 12288x1536
12288×1536
4K · 1536x12288
1536×12288

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

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

Sync (HTTP 200)

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

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

Async (HTTP 202)

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

ПолеТипЗначенияОписание
idstring— task_id для опроса через GET /v1/tasks/{id}.
objectstringimage.task
statusenumqueued, processing, completed, failed
modelstring— Public model id.
createdinteger—

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

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

ПолеТипЗначенияОписание
idstring—
objectstringtask
statusenumqueued, processing, completed, failed, canceled
modalitystringimage
modelstring—
createdinteger—
dataarray—
Каждый элемент:
  • url— string · CDN URL артефакта (если completed).
errorstring— Сообщение об ошибке (если failed).

Пример запроса

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-1",
    positivePrompt= "Пример промпта",
    width= 1,
    height= 1,
    resolution= "1K",
    seed= 1073741824,
    numberResults= 1,
    outputType= "URL",
    outputFormat= "PNG",
    outputQuality= 95,
    webhookURL= "https://example.com/...",
    uploadEndpoint= "value",
    inputs= {
        "referenceImages": [],
        "referenceVideos": []
    },
    settings= {
        "systemPrompt": "Пример промпта",
        "temperature": 1,
        "topP": 0.5,
        "thinkingLevel": "medium",
        "webSearch": False,
        "imageSearch": False,
        "safetyTolerance": "none"
    },
    safety= {
        "checkContent": False,
        "mode": "none"
    },
)
print(resp)

Замените rk_live_... на ваш ключ из кабинета.

О провайдере: Google

Google DeepMind разрабатывает семейство моделей Gemini — мультимодальные LLM с нативной поддержкой текста, изображений, аудио и видео в одном запросе. Известны рекордно длинным контекстом (до 2M токенов).

Официальный сайт: https://deepmind.google

Документация модели у вендора: https://runware.ai/docs/models/google-nano-banana-2-1