Быстрый старт
GEN202 даёт единый API-доступ к генеративным моделям через один ключ. Базовый адрес — https://api.gen202.com/v1. Текстовые модели совместимы с OpenAI: подставьте base_url в существующий клиент.
Получите ключ
Создайте sk- ключ в разделе API-ключи кабинета.
Первый вызов
Текст — POST /v1/chat/completions (model: "gpt"), картинки — POST /v1/images (model: "nb2").
Заберите ответ
Оба эндпоинта отвечают синхронно.
Аутентификация
Каждый запрос передаёт ключ в заголовке Authorization. Один ключ действует на все модели.
| Заголовок | Значение |
|---|---|
| Authorization | Bearer sk-brand-•••• |
| Content-Type | application/json |
- Храните ключ на сервере, не в клиентском коде.
- На каждый ключ — IP-whitelist, список моделей и лимит трат (в кабинете).
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, ядерная выборка |
| stream | boolean | опц. | Потоковый вывод |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
| choices[].message.content | string | Текст ответа модели |
| usage.prompt_tokens | integer | Токены входа |
| usage.completion_tokens | integer | Токены выхода |
| usage.total_tokens | integer | Всего токенов |
Images
Генерация изображений. Модель — nb2 (алиас nano-banana-2). Шлюз держит асинхронную задачу у провайдера и возвращает готовую ссылку.
Параметры тела (application/json)
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| model | string | required | "nb2" — алиас nano-banana-2 |
| prompt | string | required | Текстовое описание изображения |
| aspect_ratio | enum | опц. | 1:1 / 16:9 / 9:16 (по умолч. 1:1) |
| resolution | enum | опц. | 1K / 2K / 4K (по умолч. 1K) |
Ответ 200
| Поле | Тип | Описание |
|---|---|---|
| data[].url | string | Ссылка на готовое изображение |
| credits_charged | string | Фактически списанные кредиты |
Списание: 14 кр. (1K) / 22 (2K) / 29 (4K). Неуспешные задачи не тарифицируются.
Вебхуки
Укажите URL вебхука в настройках — GEN202 отправит POST при событиях task.done и task.error.
Каждый вызов подписан заголовком X-Gen202-Signature (HMAC-SHA256). Проверяйте подпись секретом вебхука, прежде чем доверять телу запроса.
Лимиты и эксплуатация
Лимит скорости
20 запросов генерации за 10 секунд на аккаунт (≈100+ параллельных задач). Сверх — HTTP 429, без очереди; повторяйте с экспоненциальной задержкой.
Логи и хранение
Каждый вызов виден в кабинете (модель, Task ID, кредиты, статус, параметры). Результаты медиа-задач доступны по ссылке ограниченное время — забирайте файлы на свою сторону.