PointAPI
API генерации изображений

Nano Banana 2 4K API — цены и подключение

Nano Banana 2 4K: API генерации изображений. Подключайте модель через Point API с точным model ID и указанными ниже параметрами. Перед генерацией сравните опубликованные тарифы для нужного набора настроек.

ID модели: nanobanano-2-4k

Включено в опубликованной конфигурации

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

Цены API в USD

Цены «Creator −10%» на 10% ниже стоимости генераций по тарифу Studio Creator в пересчёте на USD. У моделей, доступных только через API, отдельные тарифы. Тариф за запрос или диапазон символов — полная стоимость для указанных настроек; цены за изображение и секунду умножаются на количество и длительность. Токеновые ставки применяются только там, где указаны явно. Отсутствующая или устаревшая цена означает недоступность, а не бесплатный доступ.

Creator −10%

Nano Banana 2 4K — Цены API в USD
ЦенаЦены API в USDПараметры тарифа
0.131464 USDза запрос{"count": 1}
0.262929 USDза запрос{"count": 2}
0.525857 USDза запрос{"count": 4}

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

Nano Banana 2 4K — Поддерживаемые параметры API
ПараметрТипДопустимые значения
promptstring
Обязательный
Минимум (minLength): 1
Максимум (maxLength): 32000
ratiostring
Необязательный
Допустимые значения ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"]
По умолчанию (default): "1:1"
stylestring
Необязательный
Допустимые значения ["standard", "realistic", "artistic", "anime", "cinematic"]
По умолчанию (default): "standard"
countinteger
Необязательный
Допустимые значения [1, 2, 4]
По умолчанию (default): 1
Минимум (minimum): 1
Максимум (maximum): 4
imagesarray
Необязательный
Максимум элементов (maxItems): 4
items: {"format": "data-url", "type": "string"}
preserve_reference_identitiesboolean
Необязательный
По умолчанию (default): false
capabilities
{
  "additionalProperties": false,
  "max_reference_images": 4
}

Опубликованный контракт допускает до 4 изображений-референсов. Используйте только описанные для модели поля и роли референсов; этот лимит не означает поддержку других типов медиа.

Подключение модели

Point API использует собственный контракт REST JSON и асинхронные задания генерации. Храните API-ключи на своём сервере, а не в публичном коде сайта.

  1. Запросите GET /v1/models и выберите точный model ID, допустимые входные поля и опубликованный тариф.
  2. Создайте в кабинете API-ключ с доступом к модели и проверьте, что баланса в USD хватает на запрос.
  3. Отправьте REST JSON на POST /v1/generations с Authorization: Bearer и Idempotency-Key. При повторе той же операции используйте прежний ключ только с тем же телом запроса.
  4. Опрашивайте GET /v1/generations/{id} с тем же полученным ID генерации. Запрос выполняется асинхронно; при состоянии unknown продолжайте проверять этот ID, а не создавайте новую платную генерацию.
POST https://pointgpt.io/v1/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: YOUR_UNIQUE_REQUEST_ID

{
  "model": "nanobanano-2-4k",
  "input": {
    "prompt": "Керамический чайник на деревянном столе, мягкий утренний свет, простой фон."
  }
}

Первый ответ подтверждает приём запроса, а не готовый результат. Проверяйте состояние и результат по тому же ID генерации. Формат результата и доступ к медиа зависят от модели и прав аккаунта.

Документация API

cURL / Python

POINT_API_KEY · POINT_REQUEST_ID

cURL

curl https://pointgpt.io/v1/generations \
  -H "Authorization: Bearer $POINT_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $POINT_REQUEST_ID" \
  --data-raw '{
  "model": "nanobanano-2-4k",
  "input": {
    "prompt": "Керамический чайник на деревянном столе, мягкий утренний свет, простой фон."
  }
}'

Python

import json
import os
from urllib.request import Request, urlopen

payload = json.loads('{\n  "model": "nanobanano-2-4k",\n  "input": {\n    "prompt": "Керамический чайник на деревянном столе, мягкий утренний свет, простой фон."\n  }\n}')
request = Request('https://pointgpt.io/v1/generations', method='POST',
    data=json.dumps(payload).encode('utf-8'),
    headers={
        'Authorization': 'Bearer ' + os.environ['POINT_API_KEY'],
        'Content-Type': 'application/json',
        'Idempotency-Key': os.environ['POINT_REQUEST_ID'],
    })
with urlopen(request, timeout=60) as response:
    job = json.load(response)
print(job['id'])

Вопросы об API

Как рассчитывается стоимость запроса?

Цены «Creator −10%» на 10% ниже стоимости генераций по тарифу Studio Creator в пересчёте на USD. У моделей, доступных только через API, отдельные тарифы. Тариф за запрос или диапазон символов — полная стоимость для указанных настроек; цены за изображение и секунду умножаются на количество и длительность. Токеновые ставки применяются только там, где указаны явно. Отсутствующая или устаревшая цена означает недоступность, а не бесплатный доступ. Стоимость фиксируется при приёме запроса.

Можно ли использовать OpenAI-совместимый клиент или потоковую выдачу?

Подключайте документированные REST JSON-методы Point API. Этот контракт не заявляет OpenAI-совместимость или потоковую выдачу. Используйте форматы запросов и ответов из документации API.

Как получить результат генерации?

Отправка создаёт асинхронное задание. Сохраните его ID и опрашивайте GET /v1/generations/{id}, чтобы получить состояние и результат. Состояние unknown не означает, что нужно отправить запрос заново: продолжайте проверять прежний ID.

Похожие модели