Интеграции

Подключение API к автоматизациям и ботам: n8n, Make, Telegram.

Популярные интеграции

n8n

HTTP Request node для запуска генерации и polling статуса.

Make

Сценарий из модулей: Generate → Sleep → Status → Download.

Telegram

Боты с голосовыми ответами и персонализацией голоса под пользователя.

Открыть API-документацию

Как это подключается на самом деле

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

Три шага, одинаковые везде

  1. Запуск. POST https://genius-bot.ru/wp-json/genius/v1/generate с заголовком Authorization: Bearer <ключ> и телом {"service":"tts","text":"…","voice":"…"}. В ответ приходит номер задачи.
  2. Ожидание. GET https://genius-bot.ru/wp-json/genius/v1/tasks/{id} раз в несколько секунд, пока состояние не станет completed. Либо, чтобы не опрашивать вовсе, при запуске передать callback_url — на него придёт POST, когда файл будет готов.
  3. Забор файла. В готовой задаче лежит ссылка на аудио — её отдают дальше: в бот, в облако, в монтажную папку.

n8n

Узел HTTP Request с методом POST на /generate, дальше Wait на 10–15 секунд и второй HTTP Request на /tasks/{id} внутри узла If: пока состояние pending — возвращаемся к ожиданию. Ключ храните в Credentials, а не в теле узла: иначе он уедет вместе с экспортом сценария.

Make

Цепочка из четырёх модулей: HTTP → Make a request (запуск), Sleep, HTTP → Make a request (состояние) и HTTP → Get a file (скачивание). Ветку повтора удобнее собрать через Repeater с выходом по состоянию completed.

Telegram-бот

Бот принимает текст сообщением, ставит задачу и отвечает голосовым, когда файл готов. Формат opus_48000_64 подходит для голосовых лучше прочих: он и есть тот кодек, в котором Telegram хранит голосовые сообщения. Ответ придёт не мгновенно — предупредите об этом одним сообщением, иначе человек отправит текст второй раз и заплатит дважды.

Что стоит учесть до запуска

  • Частота: не больше 60 запросов в минуту на ключ.
  • Оплата за запуск, без абонплаты: считайте бюджет по знакам текста, который пойдёт через сценарий.
  • Ключ показывается один раз при выпуске — сохраните его сразу.
  • Сервис отдаёт аудиофайл: сведение с видео, субтитры и тайм-коды остаются за вами.

Документация и ключ Попробовать руками