Одной моделью делает и генерацию по описанию, и правку присланного изображения.
Модель поставщика Google. Через GEN202 она вызывается по идентификатору
nano-banana-pro тем же ключом, что остальные модели каталога:
запрос уходит на /v1/images, шлюз дожидается результата у
поставщика и возвращает ссылку на изображение и списанные кредиты.
model запроса.Ключ создаётся в кабинете. Сюда он вводится на время запуска и никуда не сохраняется.
Запуск тратит кредиты: до генерации удерживается 43 кредита, списывается фактический расход.
model — nano-banana-proprompt — текст · от 1 до 10 000 символов · обязательноеaspect_ratio — значение из списка · 1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · autoresolution — значение из списка · 1K · 2K · 4Koutput_format — значение из списка · png · jpgimage_input — список ссылок · до 8 ссылок на изображение{ "model": "nano-banana-pro", "prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет", "aspect_ratio": "1:1", "resolution": "1K" }
Тело собирается из формы: заполните поля на вкладке Form — здесь видно, что уйдёт на шлюз.
Нажмите «Запустить» — изображение появится здесь
Ответ шлюза появится здесь после запуска.
Поля тела запроса. Значения проверяются до обращения к поставщику: поле не из списка
или значение вне перечисления возвращают ошибку 400 и кредитов не тратят.
| Поле | Тип | Обяз. | Допустимые значения |
|---|---|---|---|
| model | текст | обязательное | nano-banana-pro |
| prompt | текст | обязательное | от 1 до 10 000 символов |
| aspect_ratio | значение из списка | опц. |
1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9 · auto
· без него шлюз подставит 1:1
|
| resolution | значение из списка | опц. |
1K · 2K · 4K
· без него шлюз подставит 1K
|
| output_format | значение из списка | опц. |
png · jpg
· без него шлюз подставит png
|
| image_input | список ссылок | опц. | до 8 ссылок на изображение |
Поле, которого нет в таблице, шлюз не принимает: запрос с незнакомым именем отбивается с перечнем допустимых полей, чтобы опечатка не превратилась в оплаченную генерацию не того, что просили. Общие для всех моделей поля тела запроса и формат ответа описаны в разделе документации Images.
Цена считается за генерацию. Наша розница — официальная цена первоисточника минус 10%, счёт выставляется целыми кредитами по курсу 1 кредит = $0.005.
| Ступень | Наша цена, кредиты | Наша цена, USD | Официал, USD | Разница |
|---|---|---|---|---|
| 1 за генерацию | 24 | $0.12 | $0.134 | −10,4% |
| 2 за генерацию | 43 | $0.215 | $0.24 | −10,4% |
Эти же ступени стоят отдельными строками в общем прайсе — там цена Google Nano Banana Pro видна рядом с ценами остальных моделей каталога: строка в прайсе.
POST /v1/images — шлюз сам дожидается результата
у поставщика и отвечает ссылкой на изображение. В примере — обязательные поля модели и значения из её
перечислений.
curl https://api.gen202.com/v1/images \
-H "Authorization: Bearer sk-ваш-ключ" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-pro",
"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-pro",
"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.
Ключ для примера выпускается в кабинете; как он передаётся в заголовке, описано в разделе Аутентификация, а ограничение скорости запросов — в разделе Лимиты и эксплуатация.
Модели того же поставщика, модели с той же задачей и разделы, где о Google Nano Banana Pro сказано отдельно.
Кроме Google Nano Banana Pro, на витрине есть ещё 1 модель этого поставщика.
Модель делает и то и другое, поэтому попадает в оба раздела каталога.
Ту же задачу у других поставщиков решают:
Строка этой модели в общем прайсе — все её ступени рядом с ценами остальных моделей.
Быстрый старт — Базовый адрес шлюза и первый вызов через один ключ.
Аутентификация — Как передать ключ в заголовке запроса.
Images — Эндпоинт /v1/images, через который вызывается эта модель.
Лимиты и эксплуатация — Ограничение скорости запросов и логи вызовов в кабинете.