Одной моделью делает и генерацию по описанию, и правку присланного изображения. Вызывается через POST /v1/images по
идентификатору nano-banana-2 — тем же ключом, что остальные модели
каталога.
model запроса.Ключ создаётся в кабинете. Сюда он вводится на время запуска и никуда не сохраняется.
Запуск тратит кредиты: списывается фактический расход, а неуспешная задача не тарифицируется.
model — nano-banana-2prompt — текст · от 1 до 20 000 символов · обязательноеaspect_ratio — значение из списка · 1:1 · 1:4 · 1:8 · 2:3 · 3:2 · 3:4 · 4:1 · 4:3 · 4:5 · 5:4 · 8:1 · 9:16 · 16:9 · 21:9 · autoresolution — значение из списка · 1K · 2K · 4Koutput_format — значение из списка · png · jpgimage_input — список ссылок · до 14 ссылок на изображение{ "model": "nano-banana-2", "prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет", "aspect_ratio": "1:1", "resolution": "1K" }
Тело собирается из формы: заполните поля на вкладке Form — здесь видно, что уйдёт на шлюз.
Нажмите «Запустить» — изображение появится здесь
Ответ шлюза появится здесь после запуска.
Поля тела запроса. Значения проверяются до обращения к поставщику: поле не из списка
или значение вне перечисления возвращают ошибку 400 и кредитов не тратят.
| Поле | Тип | Обяз. | Допустимые значения |
|---|---|---|---|
| model | текст | обязательное | nano-banana-2 |
| prompt | текст | обязательное | от 1 до 20 000 символов |
| aspect_ratio | значение из списка | опц. |
1:1 · 1:4 · 1:8 · 2:3 · 3:2 · 3:4 · 4:1 · 4:3 · 4:5 · 5:4 · 8:1 · 9:16 · 16:9 · 21:9 · auto
· без него шлюз подставит 1:1
|
| resolution | значение из списка | опц. |
1K · 2K · 4K
· без него шлюз подставит 1K
|
| output_format | значение из списка | опц. |
png · jpg
· без него шлюз подставит png
|
| image_input | список ссылок | опц. | до 14 ссылок на изображение |
Поле, которого нет в таблице, шлюз не принимает: запрос с незнакомым именем отбивается с перечнем допустимых полей, чтобы опечатка не превратилась в оплаченную генерацию не того, что просили. Общие для всех моделей поля тела запроса и формат ответа описаны в разделе документации Images.
Цена считается за генерацию. Наша розница — официальная цена первоисточника минус 10%, счёт выставляется целыми кредитами по курсу 1 кредит = $0.005.
| Вариант | Наша цена, кредиты | Наша цена, USD | Официал, USD | Разница |
|---|---|---|---|---|
| 1K за генерацию | 14 | $0.07 | $0.08 | −12,5% |
| 2K за генерацию | 22 | $0.11 | $0.12 | −8,3% |
| 4K за генерацию | 29 | $0.145 | $0.16 | −9,4% |
Эти же варианты стоят отдельными строками в общем прайсе — там цена Google Nano Banana 2 видна рядом с ценами остальных моделей каталога: строка в прайсе.
POST /v1/images — шлюз сам дожидается результата
у поставщика и отвечает ссылкой на изображение. В примере — обязательные поля модели и значения из её
перечислений.
curl https://api.gen202.com/v1/images \
-H "Authorization: Bearer sk-ваш-ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2",
"prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет",
"aspect_ratio": "1:1",
"resolution": "1K"
}'import requests
r = requests.post(
"https://api.gen202.com/v1/images",
headers={"Authorization": "Bearer sk-ваш-ключ"},
json={
"model": "nano-banana-2",
"prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет",
"aspect_ratio": "1:1",
"resolution": "1K"
},
).json()
print(r["data"][0]["url"], r["credits_charged"])
Ответ содержит data[0].url со ссылкой на изображение и
credits_charged со списанными кредитами. Эта же модель доступна задачами:
POST /api/v1/jobs/createTask с теми же полями внутри input.
Ключ для примера выпускается в кабинете; как он передаётся в заголовке, описано в разделе Аутентификация, а ограничение скорости запросов — в разделе Лимиты и эксплуатация.
Модели того же поставщика и модели с той же задачей в каталоге GEN202.
Отобранный каталог целиком:
Модели того же поставщика, модели с той же задачей и разделы, где о Google Nano Banana 2 сказано отдельно.
Другие модели этого поставщика.
Модель делает и то и другое, поэтому попадает в оба раздела каталога.
Ту же задачу у других поставщиков решают:
Строка этой модели в общем прайсе — все её варианты рядом с ценами остальных моделей.
Быстрый старт — Базовый адрес шлюза и первый вызов через один ключ.
Аутентификация — Как передать ключ в заголовке запроса.
Images — Эндпоинт /v1/images, через который вызывается эта модель.
Лимиты и эксплуатация — Ограничение скорости запросов и логи вызовов в кабинете.