Nano Banana 2.1 API

ПровайдерGoogle

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

image_to_imageweb_search

Попробуйте прямо здесь

Nano Banana 2.1 Открыть в песочнице

Что умеет Nano Banana 2.1

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

Стоимость

за 1 млн входных текстовых токенов

Входные токены

200 ₽

за 1 млн выходных текстовых токенов

Текстовые выходные токены

998 ₽

за 1 млн выходных токенов изображения

Выходные токены изображения

3 990 ₽

за изображение

Ориентировочно 1K

4.94 ₽

Ориентировочно 1K · 1024x1024

4.94 ₽

Ориентировочно 1K · 1264x848

4.94 ₽

Ориентировочно 1K · 848x1264

4.94 ₽

Ориентировочно 1K · 1200x896

4.94 ₽

Ориентировочно 1K · 896x1200

4.94 ₽

Ориентировочно 1K · 928x1152

4.94 ₽

Ориентировочно 1K · 1152x928

4.94 ₽

Ориентировочно 1K · 768x1376

4.94 ₽

Ориентировочно 1K · 1376x768

4.94 ₽

Ориентировочно 1K · 1584x672

4.94 ₽

Ориентировочно 1K · 2048x512

4.94 ₽

Ориентировочно 1K · 512x2048

4.94 ₽

Ориентировочно 1K · 3072x384

4.94 ₽

Ориентировочно 1K · 384x3072

4.94 ₽

Ориентировочно 2K · 2048x2048

7.41 ₽

Ориентировочно 2K · 2528x1696

7.41 ₽

Ориентировочно 2K · 1696x2528

7.41 ₽

Ориентировочно 2K · 2400x1792

7.41 ₽

Ориентировочно 2K · 1792x2400

7.41 ₽

Ориентировочно 2K · 1856x2304

7.41 ₽

Ориентировочно 2K · 2304x1856

7.41 ₽

Ориентировочно 2K · 1536x2752

7.41 ₽

Ориентировочно 2K · 2752x1536

7.41 ₽

Ориентировочно 2K · 3168x1344

7.41 ₽

Ориентировочно 2K · 4096x1024

7.41 ₽

Ориентировочно 2K · 1024x4096

7.41 ₽

Ориентировочно 2K · 6144x768

7.41 ₽

Ориентировочно 2K · 768x6144

7.41 ₽

Ориентировочно 2K

7.41 ₽

Ориентировочно 4K · 4096x4096

17.29 ₽

Ориентировочно 4K · 5056x3392

17.29 ₽

Ориентировочно 4K · 3392x5056

17.29 ₽

Ориентировочно 4K · 4800x3584

17.29 ₽

Ориентировочно 4K · 3584x4800

17.29 ₽

Ориентировочно 4K · 3712x4608

17.29 ₽

Ориентировочно 4K · 4608x3712

17.29 ₽

Ориентировочно 4K · 3072x5504

17.29 ₽

Ориентировочно 4K · 5504x3072

17.29 ₽

Ориентировочно 4K · 6336x2688

17.29 ₽

Ориентировочно 4K · 8192x2048

17.29 ₽

Ориентировочно 4K · 2048x8192

17.29 ₽

Ориентировочно 4K · 12288x1536

17.29 ₽

Ориентировочно 4K · 1536x12288

17.29 ₽

Ориентировочно 4K

17.29 ₽

за запрос

Ориентировочная надбавка за референсы

5.32 ₽

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

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

Vendor

google

Modality

image

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

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

ПараметрТипДиапазон / значенияПо умолчаниюОписание

positivePromptreq

string

min: 3 · max: 45000

—

Описание изображения или требуемых изменений.

1 пример

Примеры

Красный куб на белом фоне.

width

integer

—

—

Ширина в пикселях: строго одна из 42 пар с height. Вместе с resolution не используется.

height

integer

—

—

Высота в пикселях. Требуется вместе с width. Несовместима с resolution.

resolution

enum

1K, 2K, 4K

—

Автоматический формат по референсам: требует inputs.referenceImages, несовместим с width/height.

inputs.referenceImages

array of strings

min: 1 · max: 14

—

Референсы и изображения для редактирования: URL, UUID или data URI.

1 пример

Примеры

[
  "https://example.com/reference.png"
]

inputs.referenceVideos

array of strings

min: 1 · max: 1

—

Один референс-видеофайл.

seed

integer

min: 0 · max: 2147483647

—

Начальное значение генератора; 0 является допустимым значением.

settings.systemPrompt

string

min: 1 · max: 50000

—

Системные инструкции для генерации.

settings.temperature

number

min: 0 · max: 2

—

Вариативность результата.

settings.topP

number

min: 0 · max: 1

—

Порог вероятностной выборки.

settings.thinkingLevel

enum

minimal, medium, high

medium

Уровень рассуждений.

settings.webSearch

boolean

—

false

Использовать поиск в интернете.

settings.imageSearch

boolean

—

false

Использовать поиск изображений.

settings.safetyTolerance

enum

high, medium, low, none, off

none

Уровень фильтрации контента.

numberResults

integer

min: 1 · max: 4

1

Количество результатов.

outputType

enum

URL, base64Data, dataURI

URL

Способ возврата изображения.

outputFormat

enum

PNG, JPG, WEBP

PNG

Формат выходного изображения.

outputQuality

integer

min: 20 · max: 99

95

Качество компрессии изображения.

safety.checkContent

boolean

—

false

Дополнительная проверка безопасности результата.

safety.mode

enum

none, fast, full

none

Режим дополнительной проверки.

webhookURL

string

—

—

URL для уведомления провайдера о готовности.

uploadEndpoint

string

—

—

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.

ПолеТипЗначенияОписание

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-1_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-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)

Полная документация модели

Частые вопросы о Nano Banana 2.1

Nano Banana 2.1 — модель Google для генерации и редактирования изображений по текстовому описанию и изображениям-референсам.

Модель подходит для создания и правки изображений по описанию и референсам. Можно выбрать пропорции кадра, разрешение и уровень Thinking.

Получить доступ можно в Ranvik API: создайте API-ключ, выберите nano-banana-2-1 и отправьте запрос генерации с текстовым описанием.

Используйте Ranvik API с единым API-ключом: модель доступна через API генерации изображений. Документация содержит параметры и примеры запросов.

В Ranvik API доступна оплата в российских рублях. Ожидаемая цена зависит от параметров, а итоговое списание учитывает стоимость генерации.

Модель поддерживает разрешения 1K, 2K и 4K, до 14 изображений-референсов и настройки Thinking. Доступные параметры указаны в документации.

Nano Banana 2.1 API

Попробуйте прямо здесь

Что умеет Nano Banana 2.1

Стоимость

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

Nano Banana 2.1 — генерация и редактирование изображений

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

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

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

Sync (HTTP 200)

Async (HTTP 202)

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

Пример кода

Частые вопросы о Nano Banana 2.1

Могут заинтересовать