HTTP API

API для разработчиков: нейросети в вашем сервисе

Оживление фото, говорящий аватар, редактирование картинок, звуки и озвучка — те же инструменты, что и на сайте, только вызываются из вашего кода. Один ключ, один формат запроса, оплата с общего баланса аккаунта.

без абонплаты — платите за запуск REST + JSON вебхук о готовности озвучка и расшифровка

Ключ доступа

Ключ выдаётся в аккаунте: он привязан к балансу, с которого списывается оплата.

Войти и получить ключ

Быстрый старт

Все запросы идут на https://genius-bot.ru/wp-json/genius/v1, ключ передаётся заголовком Authorization: Bearer <ключ>. Ответы — JSON в UTF-8. Схема одна для всех операций: поставили задачу, получили task_id, забрали результат по нему.

Запустить оживление фото
curl -X POST https://genius-bot.ru/wp-json/genius/v1/generate \
  -H 'Authorization: Bearer ВАШ_КЛЮЧ' \
  -H 'Content-Type: application/json' \
  -d '{
    "service": "photo-video",
    "image_url": "https://example.com/photo.jpg",
    "prompt": "лёгкая улыбка, поворот головы"
  }'

В ответе — task_id, списанная сумма и остаток баланса. Статус запрашивайте раз в 5–10 секунд: картинка обычно готова за 10–40 секунд, видео и аватар — за 1–5 минут.

Ответ
// ответ на POST /generate
{
  "task_id": "a1b2c3d4",
  "service": "photo-video",
  "status": "pending",
  "cost": 25,
  "balance": 475
}

// GET /tasks/a1b2c3d4 после готовности
{
  "task_id": "a1b2c3d4",
  "status": "completed",
  "files": [
    { "label": "Результат", "kind": "video", "url": "https://…/result.mp4" }
  ]
}

Что можно вызвать

serviceЧто делаетОбязательные поляЦена
photo-video Оживить фото Из фотографии получается короткое видео: движение головы, мимика, лёгкая камера. image_url 25 ₽ за запуск
image-edit Изменить фото по описанию Замена фона и одежды, удаление объектов, реставрация — словами, без редактора. image_url, prompt 35 ₽ за запуск
image Картинка по описанию Изображение из текста — для карточек товара, обложек и иллюстраций. prompt 9 ₽ за запуск
upscale Увеличить качество фото Апскейл вдвое с восстановлением деталей: для старых снимков и мелких картинок. image_url 50 ₽ за запуск
avatar Говорящий аватар Фотография плюс запись голоса — видео, где человек со снимка говорит. image_url, audio_url 12 ₽ за секунду видео, минимум 120 ₽
vocal Убрать вокал Две дорожки из песни: минусовка и отдельно голос. audio_url 15 ₽ за минуту записи, минимум 45 ₽
denoise Убрать шум Чистый голос без фонового гула, эха и шума улицы. audio_url 12 ₽ за минуту записи, минимум 36 ₽
sfx Звук по описанию Звуковой эффект или фон из текстового описания, MP3. prompt 9 ₽ за запуск
tts Озвучка текста Речь из текста живым голосом, больше тридцати языков. text 12 ₽ за 1000 знаков

Необязательные поля: prompt уточняет результат, callback_url включает вебхук, voice выбирает голос озвучки, mode и seconds управляют генерацией звука (sfx, ambient, loop).

Озвучка, расшифровка и звук с YouTube

Эти операции живут на отдельном адресе https://genius-bot.ru/wp-json/tts/v1/api и используют собственный ключ — он выпускается в личном кабинете озвучки, раздел «API». Передаётся заголовком X-API-Key или Authorization: Bearer.

ЗапросЧто делает
POST /generateОзвучить текст: модель, голос, формат вывода
GET /status/{task_id}Состояние озвучки и ссылка на файл
POST /transcribeРасшифровать запись: audio_url или youtube_url
GET /transcribe-status/{task_id}Текст, сегменты и тайминги
POST /youtube-audioДостать звуковую дорожку из ролика
POST /parse-text-fileДостать текст из загруженного документа
GET /balanceОстаток на балансе
GET /generationsИстория озвучек
GET /free-voicesСписок бесплатных голосов
Озвучить текст и расшифровать запись
# Озвучить текст
curl -X POST https://genius-bot.ru/wp-json/tts/v1/api/generate \
  -H 'X-API-Key: КЛЮЧ_ОЗВУЧКИ' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "elevenlabs/text-to-speech-multilingual-v2",
    "text": "Привет! Это тест.",
    "voice": "Rachel",
    "output_format": "mp3_44100_128"
  }'

# Расшифровать запись
curl -X POST https://genius-bot.ru/wp-json/tts/v1/api/transcribe \
  -H 'X-API-Key: КЛЮЧ_ОЗВУЧКИ' \
  -H 'Content-Type: application/json' \
  -d '{"audio_url": "https://example.com/audio.mp3", "language_code": "ru", "diarize": true}'

Ключи не взаимозаменяемы: gb_… работает на genius/v1, ключ озвучки — на tts/v1. Баланс у них общий, списания видны в одной истории.

Свои файлы

Ссылки в image_url и audio_url должны открываться из интернета. Если файла в открытом доступе нет, загрузите его к нам — ссылка вернётся в ответе. Фото до 10 МБ, аудио до 20 МБ.

Загрузка файла
curl -X POST https://genius-bot.ru/wp-json/genius/v1/uploads \
  -H 'Authorization: Bearer ВАШ_КЛЮЧ' \
  -F 'file=@photo.jpg' \
  -F 'kind=image'

Вебхук вместо опроса

Передайте callback_url — и мы сами постучимся POST-запросом, когда задача будет готова или сорвётся. В заголовке X-Genius-Signature придёт HMAC-SHA256 от тела запроса на секрете ключа: так вы убедитесь, что запрос наш. Секрет показывается один раз вместе с ключом.

Проверка подписи
import hmac, hashlib

def valid(body: bytes, signature: str, secret: str) -> bool:
    mine = hmac.new(secret.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mine, signature)

Ошибки и лимиты

КодКогдаЧто делать
401Ключ не передан или отозванПроверьте заголовок Authorization
402Не хватает денег на балансеПополните баланс в личном кабинете
400Нет обязательного поля или файл слишком длинныйСмотрите message в ответе
429Больше 60 запросов в минуту на ключОпрашивайте статус реже или включите вебхук
502Модель не приняла задачуПовторите запрос; деньги не списываются
503Операция временно отключенаПроверяйте /services

Если задача сорвалась уже после запуска, статус придёт как failed, а списанные деньги вернутся на баланс автоматически. Результаты хранятся у нас и доступны по прямой ссылке — скачайте их к себе, если нужны надолго.

Те же инструменты с человеческим интерфейсом

Все инструменты работают на одном балансе — переключайтесь между ними без отдельной оплаты.

Говорящий аватар

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

Сделать говорящее видео

Убрать вокал

Загрузите трек — нейросеть отделит вокал от музыки и вернёт две дорожки: чистый инструментал для караоке и отдельно голос. Ничего устанавливать не нужно.

Убрать вокал

Убрать шум

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

Очистить запись

Создать звук

Опишите звук словами — нейросеть соберёт готовый эффект в MP3: взрывы, шаги, интерфейсные сигналы, атмосфера и бесшовные лупы.

Создать звук

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

Сколько стоит доступ к API?

Абонентской платы нет: вы платите только за выполненные задачи по тем же ценам, что и на сайте. Деньги списываются с баланса аккаунта, пополнить его можно в личном кабинете.

Что будет, если генерация сорвётся?

Статус задачи станет failed, а списанная сумма вернётся на баланс автоматически. Если модель не приняла задачу, деньги вообще не списываются — ответ придёт с кодом 502.

Как долго хранятся результаты?

Файлы лежат у нас и доступны по прямой ссылке. Мы рекомендуем сразу перекладывать их в своё хранилище: так вы не зависите от чужих сроков хранения.

Можно ли использовать API в коммерческом продукте?

Да. Права на созданные файлы остаются у вас, ограничений на коммерческое применение нет. Единственное требование — не выдавать сам API за собственный и не перепродавать доступ к нему как к своему сервису.

Есть ли тестовый режим?

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

Сколько запросов в минуту выдержит ключ?

До шестидесяти. Если нужно больше, включите вебхук: тогда статус не придётся опрашивать вовсе, и лимит перестанет мешать.