Получить API-ключКлюч

API GenAPI — нейросети одним ключом

Один ключ GenAPI работает со всеми нейросетями каталога: формат OpenAI для плагинов и редакторов, основной API с очередью и вебхуками для долгих задач. Оплата рублями за запрос с баланса.

Получить API-ключДокументация

Режимы и возможности

Один ключ на все модели, режим запроса выбирается под задачу

  • Синхронный запросОтвет приходит в том же запросе, без повторных обращений
  • ОчередьПодходит для долгих задач: результат забирается по идентификатору запроса
  • ВебхукиГотовый результат приходит на ваш адрес
  • Потоковый ответТекст приходит частями по мере генерации
  • ФайлыФайлы передаются в запросе к текстовым моделям
  • Изображения на входКартинки в запросе к моделям со зрением (vision)

Три шага подключения

  1. 1

    Ключ в кабинете

    Зарегистрируйтесь на gen-api.ru, ключ создаётся в личном кабинете

  2. 2

    Адрес и ключ в коде

    В клиенте OpenAI укажите адрес proxy.gen-api.ru/v1 и свой ключ

  3. 3

    Модель в запросе

    Идентификатор нейросети из каталога укажите в параметре model, цена запроса придёт в ответе

Каким способом обращаться к нейросетям

У GenAPI два интерфейса: формат OpenAI на отдельном поддомене proxy.gen-api.ru/v1 и основной API GenAPI на api.gen-api.ru. Ключ один и тот же, различается то, как запрос уходит и как приходит результат.

Формат OpenAI нужен плагинам, редакторам кода и готовым приложениям, собранным на библиотеке OpenAI: они продолжают работать после смены адреса и ключа. Нейросеть передаётся в параметре model общим идентификатором с сайта GenAPI (например, claude) или точной подверсией. Картинки и файлы вкладываются в массив content: картинка идёт через image_url ссылкой или base64, файлы передаются там же в content. Подключение GenAPI к Cursor и Cline устроено именно так.

Основной API работает иначе: запрос на генерацию отправляется нейросети по её идентификатору из каталога моделей, а результат забирается отдельным GET-запросом по ID. В ответе приходят статус, стоимость (cost), результат (result, например ссылка на файл) и время работы. Через основной API вызываются и готовые функции вроде удаления фона или презентации: каждая запускается отдельным запросом к функции.

Что делать с долгими задачами: видео, музыка, 3D

Видео, музыку и 3D основной API обрабатывает через очередь и вебхуки: запрос ставится в очередь, а результат приходит позже на адрес вебхука, который вы указали.

Для видео и 3D выбирайте вебхук вместо удержания соединения: результат придёт на ваш адрес, когда генерация закончится, и коду не придётся ждать ответа. Синхронные запросы и потоковую передачу оставьте коротким задачам вроде текста и картинок.

Когда списываются деньги

Баланс работает по стопроцентной предоплате: сначала пополнение, потом генерация. В стандартном режиме деньги уходят с баланса в момент старта генерации, у некоторых нейросетей и долгих задач списание происходит, когда результат готов. Как сказано на gen-api.ru, «вы платите только за видимый результат генерации»: расходы растут вместе с числом запросов, без подписки.

Если баланс опустился до порога, нейросети перестают отвечать до нового пополнения. Закладывайте в баланс запас под объём своих запросов, чтобы генерация не останавливалась посреди работы.

Вопросы о подключении GenAPI по API

Подойдёт ли код, написанный под библиотеку OpenAI?

Да. Поменяйте в нём адрес на proxy.gen-api.ru/v1 и ключ на ключ GenAPI, а в model укажите идентификатор нейросети с сайта.

Можно ли передать картинку в Claude или GPT?

Да, для моделей со зрением: картинка идёт через image_url в массиве content, ссылкой или base64.

Что будет, если баланс кончился посреди работы?

Нейросети перестанут отвечать, пока вы не пополните баланс.

Есть ли SDK для Python?

От GenAPI есть PHP SDK, для Node есть пользовательский SDK. Для Python в документации есть примеры, а библиотека OpenAI подключается через формат OpenAI.