Nano Banana 2 API — цены и подключение
Nano Banana 2: API генерации изображений. Подключайте модель через Point API с точным model ID и указанными ниже параметрами. Перед генерацией сравните опубликованные тарифы для нужного набора настроек.
ID модели: nanobanano-2
Включено в опубликованной конфигурации
Открыть в песочницеЦены API в USD
Цены «Creator −10%» на 10% ниже стоимости генераций по тарифу Studio Creator в пересчёте на USD. У моделей, доступных только через API, отдельные тарифы. Тариф за запрос или диапазон символов — полная стоимость для указанных настроек; цены за изображение и секунду умножаются на количество и длительность. Токеновые ставки применяются только там, где указаны явно. Отсутствующая или устаревшая цена означает недоступность, а не бесплатный доступ.
Creator −10%
| Цена | Цены API в USD | Параметры тарифа |
|---|---|---|
| 0.021911 USD | за запрос | {"count": 1} |
| 0.043821 USD | за запрос | {"count": 2} |
| 0.087643 USD | за запрос | {"count": 4} |
Поддерживаемые параметры API
| Параметр | Тип | Допустимые значения |
|---|---|---|
prompt | stringОбязательный | Минимум (minLength): 1Максимум ( maxLength): 32000 |
ratio | stringНеобязательный | Допустимые значения ["1:1", "2:3", "3:2", "3:4", "4:3", "4:5", "5:4", "9:16", "16:9", "21:9"]По умолчанию ( default): "1:1" |
style | stringНеобязательный | Допустимые значения ["standard", "realistic", "artistic", "anime", "cinematic"]По умолчанию ( default): "standard" |
count | integerНеобязательный | Допустимые значения [1, 2, 4]По умолчанию ( default): 1Минимум ( minimum): 1Максимум ( maximum): 4 |
images | arrayНеобязательный | Максимум элементов (maxItems): 4items: {"format": "data-url", "type": "string"} |
preserve_reference_identities | booleanНеобязательный | По умолчанию (default): false |
capabilities
{
"additionalProperties": false,
"max_reference_images": 4
}Опубликованный контракт допускает до 4 изображений-референсов. Используйте только описанные для модели поля и роли референсов; этот лимит не означает поддержку других типов медиа.
Подключение модели
Point API использует собственный контракт REST JSON и асинхронные задания генерации. Храните API-ключи на своём сервере, а не в публичном коде сайта.
- Запросите GET /v1/models и выберите точный model ID, допустимые входные поля и опубликованный тариф.
- Создайте в кабинете API-ключ с доступом к модели и проверьте, что баланса в USD хватает на запрос.
- Отправьте REST JSON на POST /v1/generations с Authorization: Bearer и Idempotency-Key. При повторе той же операции используйте прежний ключ только с тем же телом запроса.
- Опрашивайте 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",
"input": {
"prompt": "Керамический чайник на деревянном столе, мягкий утренний свет, простой фон."
}
}Первый ответ подтверждает приём запроса, а не готовый результат. Проверяйте состояние и результат по тому же ID генерации. Формат результата и доступ к медиа зависят от модели и прав аккаунта.
Документация APIcURL / 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",
"input": {
"prompt": "Керамический чайник на деревянном столе, мягкий утренний свет, простой фон."
}
}'Python
import json
import os
from urllib.request import Request, urlopen
payload = json.loads('{\n "model": "nanobanano-2",\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.
Похожие модели
Nano Banana 2.1 API
nanobanano-2-1API генерации изображенийNano Banana 2.1 2K API
nanobanano-2-1-2kAPI генерации изображенийNano Banana 2.1 4K API
nanobanano-2-1-4kAPI генерации изображенийNano Banana Pro API
nanobanano-proAPI генерации изображенийNano Banana Pro 2K API
nanobanano-pro-2kAPI генерации изображенийNano Banana Pro 4K API
nanobanano-pro-4k