Начало работы

Быстрый старт

GEN202 даёт единый API-доступ к генеративным моделям через один ключ. Базовый адрес — https://api.gen202.com/v1. Текстовые модели совместимы с OpenAI: подставьте base_url в существующий клиент.

Получите ключ

Создайте sk- ключ в разделе API-ключи кабинета.

Первый вызов

Текст — POST /v1/chat/completions (model: "gpt"), картинки — POST /v1/images (model: "nano-banana-2" — страница этой модели: Google Nano Banana 2).

Заберите ответ

Оба эндпоинта отвечают синхронно.

Аутентификация

Каждый запрос передаёт ключ в заголовке Authorization. Один ключ действует на все модели.

Заголовок	Значение
Authorization	Bearer sk-brand-••••
Content-Type	application/json

Храните ключ на сервере, не в клиентском коде.
Ключ действует до отзыва в кабинете; отозванный перестаёт проходить сразу.

POST /v1/chat/completions Синхронно

Chat Completions

Текстовая генерация в формате OpenAI Chat Completions. Модель — gpt (алиас gpt-5-2). Возвращает choices и usage.

Параметры тела (application/json)

Поле	Тип	Обяз.	Описание
model	string	required	`"gpt"` — алиас gpt-5-2
messages	array	required	Сообщения с ролями `system` / `user` / `assistant`
temperature	number	опц.	0–2, по умолчанию 1
max_tokens	integer	опц.	Лимит токенов ответа
top_p	number	опц.	0–1, ядерная выборка
reasoning_effort	enum	опц.	low / high — глубина рассуждения

Ответ 200

Поле	Тип	Описание
choices[].message.content	string	Текст ответа модели
usage.prompt_tokens	integer	Токены входа
usage.completion_tokens	integer	Токены выхода
usage.total_tokens	integer	Всего токенов

POST /v1/images Синхронно для клиента

Images

Генерация и правка изображений. В поле model идёт идентификатор модели из каталога — например nano-banana-2. Шлюз держит асинхронную задачу у поставщика и возвращает готовую ссылку.

Какие значения принимает поле model

Ниже — идентификаторы всех моделей витрины: столько же значений принимает поле model этого эндпоинта. Идентификатор ведёт на страницу модели, где перечислены её поля с допустимыми значениями, показана цена по вариантам и работает песочница.

Идентификатор	Модель	Поставщик	Задача
nano-banana-2	Google Nano Banana 2	Google	Генерация и правка
nano-banana-pro	Google Nano Banana Pro	Google	Генерация и правка
gpt-image-2-text-to-image	GPT Image 2	OpenAI	Генерация из текста
gpt-image-2-image-to-image	GPT Image 2	OpenAI	Правка изображения

Модели одного поставщика собраны в своих разделах каталога: Google, OpenAI.

Параметры тела (application/json)

Набор полей у каждой модели свой и повторяет документацию её поставщика: у одной обязательны соотношение сторон и вариант качества, у другой — маска и референс. Полный список с допустимыми значениями — на странице модели, вкладка «Поля».

Поле	Тип	Обяз.	Описание
model	string	required	Идентификатор модели из каталога
prompt	string	required	Текстовое описание или указание к правке
остальные поля	по модели	по модели	Смотрите страницу модели: незнакомое поле шлюз отбивает с перечнем допустимых

Ответ 200

Поле	Тип	Описание
data[].url	string	Ссылка на готовое изображение
credits_charged	string	Фактически списанные кредиты

До генерации кредиты резервируются по самой дорогой варианты модели, списывается фактический расход. Цена каждой модели — на странице цен. Неуспешные задачи не тарифицируются.

Лимиты и эксплуатация

Лимит скорости

На ключ: 60 запросов в минуту на /v1/chat/completions и 10 запросов в минуту на /v1/images. Сверх — HTTP 429; повторяйте с экспоненциальной задержкой.

Логи

Каждый вызов виден в кабинете: модель, эндпоинт, статус, кредиты и длительность.

Куда идти дальше

У документации нет подвала, поэтому остальные разделы сайта перечислены здесь.

Каталог моделей — модели генерации и правки изображений с отбором по поставщику и по задаче.
Цены — все варианты каждой модели в кредитах рядом с официальной ценой первоисточника.
Кабинет — выпуск и отзыв ключей, баланс, логи вызовов и пополнение.
Обновления — какие модели и возможности появились и когда.
Условия использования и политика конфиденциальности — правила работы с сервисом и обработка данных.