GENERONIUM
Тарифы
кр.ВойтиВойтиКабинетРегистрация
API · КЛЮЧИ · ВЕБХУКИ · ПЕСОЧНИЦА

Запускайте наши сервисы из своей программы

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

Выпустить ключОписание OpenAPI

Как это работает

Четыре шага от ключа до результата — и две вещи, которые стоит знать заранее.

1. Выпустите ключ

В кабинете, вкладка «Ключи API». Боевой ключ начинается на sk_live_ и тратит кредиты вашего аккаунта, тестовый — на sk_test_ и не тратит ничего. Ключ показывается один раз: у нас остаётся только отпечаток.

2. Выберите сервис

GET /api/v1/services отдаёт перечень: слаг, что вернётся, цену в кредитах и поля формы со списками вариантов. Ровно те же поля, что видит человек на странице сервиса.

3. Запустите

POST /api/v1/generate с телом {"service":"remove-background","input":{"photo":"https://…"}}. Ответ — задание: номер, статус, цена и ссылка на результат. Готовое приходит сразу, долгое — вебхуком.

Песочница

Добавьте "dry_run": true — и любой ключ посчитает цену, проверит поля и ответит в той же форме, ничего не списав. Тестовый ключ делает это всегда и вдобавок шлёт вебхук: приём готовности отлаживается до первого рубля.

Вебхуки

Адрес задаётся на ключе, стук приходит с заголовками X-Generonium-Timestamp и X-Generonium-Signature. Подпись — HMAC-SHA256 от строки «время.тело» вашим секретом: проверяйте её всегда, иначе прислать «готово» сможет кто угодно.

Цена и кредиты

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

Что API отдаёт — и чего не отдаёт

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

Посмотреть цены

Адреса

  1. КаталогGET /api/v1/servicesПеречень сервисов страницами по сто: слаг, цена, поля.
  2. КаталогGET /api/v1/services/{service}Один сервис: поля, варианты, обязательность, цена.
  3. РаботаPOST /api/v1/generateЗапуск. Тело: service, input, необязательный dry_run.
  4. РаботаGET /api/v1/jobs/{id}Статус и результат задания, если вебхук не пришёл.
  5. OpenAPIGET /api/v1/openapi.jsonМашиночитаемое описание — для генератора клиента.

Частые вопросы

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

Тарифы GeneroniumКредиты работают на всех сервисах

Лайт

Подписка на 30 дней

499 ₽/мес
100 кредитов в месяц
  • Начисление при оплате и каждые 30 дней
  • Автопродление отключается в личном кабинете
  • Кредиты тратятся на любой сервис Generonium
  • Точная цена сервиса видна до запуска
Выбрать тариф
хит

Про

Подписка на 30 дней

1 190 ₽/мес
260 кредитов в месяц
  • Начисление при оплате и каждые 30 дней
  • Автопродление отключается в личном кабинете
  • Кредиты тратятся на любой сервис Generonium
  • Точная цена сервиса видна до запуска
Выбрать тариф
выгодно

Макс

Подписка на 30 дней

2 490 ₽/мес
600 кредитов в месяц
  • Начисление при оплате и каждые 30 дней
  • Автопродление отключается в личном кабинете
  • Кредиты тратятся на любой сервис Generonium
  • Точная цена сервиса видна до запуска
Выбрать тариф

Начните с песочницы

Тестовый ключ ничего не стоит и работает как боевой — интеграцию можно собрать целиком, не потратив ни кредита.

Выпустить ключЦены