API для разработчиков

Создавайте продукты с Loquora API

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

REST + WebSocket120 запросов/минAPI тарифа Business
(I)Быстрый старт

Первый запрос за несколько минут

Доступ к API входит в тариф Business. Ключами управляют владелец и администраторы организации в приложении.

  1. 1

    Создайте ключ

    Откройте настройки команды в приложении Loquora, найдите раздел API-ключей и создайте ключ для интеграции.

  2. 2

    Сохраните секрет

    Сразу скопируйте полный ключ с префиксом lq_. Для безопасности он показывается только один раз.

  3. 3

    Отправьте запрос

    Передайте ключ в X-Api-Key или Authorization: Bearer и вызовите нужный эндпоинт.

(II)REST API

Три базовые возможности

POST/v1/translate

Перевод текста

Переводите до 5000 символов между поддерживаемыми языками. Ответ содержит перевод и использованную языковую пару.

Перевод текста не расходует минуты организации.

curl https://api.loquora.space/v1/translate \
  -H "X-Api-Key: lq_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Привет!","source_lang":"ru","target_lang":"en"}'
POST/v1/tts

Синтез речи

Получайте MP3 с голосом по умолчанию или разрешенным клонированным голосом участника организации.

Длительность созданного аудио списывается из общего баланса организации.

curl https://api.loquora.space/v1/tts \
  -H "Authorization: Bearer lq_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello world","language":"en"}' \
  --output speech.mp3
POST/v1/stt?language=ru

Распознавание речи

Отправьте WAV-файл размером до 25 МБ и получите текст, язык, уверенность определения и длительность аудио.

Длительность аудио списывается из общего баланса. Не указывайте language, чтобы включить автоопределение.

curl "https://api.loquora.space/v1/stt?language=ru" \
  -H "X-Api-Key: lq_your_key" \
  -H "Content-Type: audio/wav" \
  --data-binary @speech.wav
(III)Реальное время

Полный пайплайн через WebSocket

Подключитесь к wss://api.loquora.space/ws и передайте API-ключ как token в session.init. Пайплайн STT → перевод → TTS доступен без пользовательской сессии.

Если ключ отозван во время подключения, сессия получит api_key_revoked и должна завершиться. Активность ключа проверяется раз в минуту.

{
  "type": "session.init",
  "payload": {
    "token": "lq_your_key",
    "sourceCode": "ru",
    "targetCode": "en"
  }
}
(IV)Ошибки

Предсказуемые ответы

401api_key_requiredВ запросе отсутствует API-ключ.
401invalid_api_keyКлюч неверен, истек или был отозван.
403api_access_not_allowedУ организации нет активного доступа к API.
429rate_limit_exceededПревышен лимит 120 запросов в минуту. Используйте заголовок Retry-After.
429usage_limit_reachedЛимит тарифа и дополнительный баланс минут исчерпаны.
Храните ключи в секрете. Не добавляйте API-ключ в браузерный код, публичные репозитории или мобильные клиенты. Храните его на своем сервере и сразу отзывайте при возможной утечке.