Быстрый старт
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 |
- Храните ключ на сервере, не в клиентском коде.
- Ключ действует до отзыва в кабинете; отозванный перестаёт проходить сразу.
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 | Всего токенов |
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). Неуспешные задачи не тарифицируются.
Лимиты и эксплуатация
Лимит скорости
На ключ: 60 запросов в минуту на /v1/chat/completions и 10 запросов в минуту на /v1/images. Сверх — HTTP 429; повторяйте с экспоненциальной задержкой.
Логи и хранение
Каждый вызов виден в кабинете: модель, эндпоинт, статус, кредиты и длительность. Ссылка на готовое изображение живёт ограниченное время — забирайте файл на свою сторону.