Трансляция

Скачать схему

Примечание: конечная точка Start streaming может использоваться только для запуска трансляции с устройства Kaleo Connect. Эта конечная точка не может использоваться для запуска трансляции из веб-браузера. Все остальные конечные точки трансляции управляют как браузером, так и устройствами Kaleo Connect.

Получить статус трансляции

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Получить текущую сессию и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

Получить статус трансляции › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Получить статус трансляции › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

true во время активной сессии, включая запуск, переподключения и завершение. Не подтверждает поступление аудио.

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

GET/v1/church/{churchId}/streaming

curl https://babel.withkaleo.com/v1/church/:churchId/streaming \
  --header 'Authorization: Bearer <token>'

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Начать трансляцию

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Начать трансляцию на устройстве Kaleo Connect с использованием сохранённых настроек. Опциональное тело запроса может выбрать deviceId и переопределить настройки для этой сессии. Без deviceId Kaleo выбирает аудиоисточник по умолчанию, настроенный на странице Kaleo Connect (в разделе Интеграции) в вашей панели управления, если доступно несколько аудиоустройств, или единственное доступное аудиоустройство, если оно одно.

Начать трансляцию › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Начать трансляцию › Тело запроса необязательно

StartStreaming

deviceId

string

Опциональный ID устройства аудиоисточника из GET /devices. Переопределяет аудиоисточник по умолчанию церкви для этой сессии. Если не указан, используется сохранённый аудиоисточник по умолчанию или единственное аудиоустройство; при наличии нескольких устройств без выбора по умолчанию требуется выбор. Выбранное устройство должно быть готово.

object

Настройки только для этой сессии. Пропущенные поля используют сохранённые значения по умолчанию.

Начать трансляцию › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Пример тела запроса

{}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Остановить трансляцию

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Остановить текущую потоковую сессию. Тело запроса не требуется.

Остановить трансляцию › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Остановить трансляцию › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

Изменить голос перевода

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

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

Изменить голос перевода › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Изменить голос перевода › Тело запроса

ChangeVoice

voice

string · enum · обязательно

Голос перевода. Может изменяться во время бездействия или трансляции.

Значения перечисления:

male

female

Изменить голос перевода › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

PATCH/v1/church/{churchId}/streaming/voice

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/voice \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "voice": "female"
}'

Пример тела запроса

{
  "voice": "female"
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Изменить видимость

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Показать или скрыть субтитры во время бездействия или трансляции. Скрытие субтитров не останавливает сессию.

Изменить видимость › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Изменить видимость › Тело запроса

ChangeVisibility

visible

boolean · обязательно

true показывает субтитры; false скрывает их при продолжающейся трансляции.

Изменить видимость › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Пример тела запроса

{
  "visible": false
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Очистить субтитры

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Очистить текущую ленту субтитров. Тело запроса не требуется.

Очистить субтитры › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Очистить субтитры › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Изменить время автоостановки

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Установить время автоостановки для активной сессии. Возвращает обновлённый статус трансляции.

Изменить время автоостановки › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Изменить время автоостановки › Тело запроса

ChangeDeadline

deadlineAt

string · date-time · обязательно

Будущее время автоостановки с Z или смещением часового пояса. Не позже шести часов после startedAt.

Изменить время автоостановки › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Пример тела запроса

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Корректировать время автоостановки

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

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

Корректировать время автоостановки › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Корректировать время автоостановки › Тело запроса

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · обязательно

Секунды для добавления к длительности бездействия или текущему сроку; отрицательные значения вычитают. Не может быть 0. Длительность бездействия: 60–21600 секунд. Живой срок: будущее, в пределах шести часов от startedAt.

Корректировать время автоостановки › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Пример тела запроса

{
  "deltaSeconds": 120
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Устройства Сессии

Kaleo API

Трансляция

Скачать схему

Получить статус трансляции

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Получить текущую сессию и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

Получить статус трансляции › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Получить статус трансляции › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

GET/v1/church/{churchId}/streaming

curl https://babel.withkaleo.com/v1/church/:churchId/streaming \
  --header 'Authorization: Bearer <token>'

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Начать трансляцию

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Начать трансляцию › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Начать трансляцию › Тело запроса необязательно

StartStreaming

deviceId

string

object

Настройки только для этой сессии. Пропущенные поля используют сохранённые значения по умолчанию.

Начать трансляцию › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Пример тела запроса

{}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Остановить трансляцию

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Остановить текущую потоковую сессию. Тело запроса не требуется.

Остановить трансляцию › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Остановить трансляцию › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

Изменить голос перевода

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

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

Изменить голос перевода › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Изменить голос перевода › Тело запроса

ChangeVoice

voice

string · enum · обязательно

Голос перевода. Может изменяться во время бездействия или трансляции.

Значения перечисления:

male

female

Изменить голос перевода › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

PATCH/v1/church/{churchId}/streaming/voice

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/voice \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "voice": "female"
}'

Пример тела запроса

{
  "voice": "female"
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Изменить видимость

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Изменить видимость › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Изменить видимость › Тело запроса

ChangeVisibility

visible

boolean · обязательно

true показывает субтитры; false скрывает их при продолжающейся трансляции.

Изменить видимость › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Пример тела запроса

{
  "visible": false
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Очистить субтитры

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Очистить текущую ленту субтитров. Тело запроса не требуется.

Очистить субтитры › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Очистить субтитры › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Изменить время автоостановки

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Установить время автоостановки для активной сессии. Возвращает обновлённый статус трансляции.

Изменить время автоостановки › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Изменить время автоостановки › Тело запроса

ChangeDeadline

deadlineAt

string · date-time · обязательно

Будущее время автоостановки с Z или смещением часового пояса. Не позже шести часов после startedAt.

Изменить время автоостановки › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Пример тела запроса

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Корректировать время автоостановки

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Корректировать время автоостановки › Параметры пути

churchId

string · обязательно

ID вашей церкви. Скопируйте его со страницы API (в разделе Интеграции) в вашей панели управления.

Корректировать время автоостановки › Тело запроса

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · обязательно

Корректировать время автоостановки › Ответы

Успешно

Текущая сессия и общие настройки церкви. Все поля присутствуют, включая состояние бездействия.

StreamingStatus

streaming

boolean · обязательно

sessionId

string | null · обязательно

Текущий ID сессии; null во время бездействия.

startedAt

string | null · date-time · обязательно

Время начала текущей сессии; null во время бездействия.

deadlineAt

string | null · date-time · обязательно

Время автоматической остановки; null во время бездействия или если срок не установлен.

speakerLanguage

string | null · обязательно

Код языка диктора; null во время бездействия.

targetLanguages

string[] · обязательно

Коды языков перевода; пусто во время бездействия.

voice

string · enum · обязательно

Голос перевода, включая состояние бездействия.

Значения перечисления:

male

female

visible

boolean · обязательно

true показывает субтитры; false скрывает их. Также применяется во время бездействия.

publisher

object | null · обязательно

Устройство Kaleo Connect или браузер, отправляющий аудио; null во время бездействия.

phase

string · enum · обязательно

Этап сессии; idle означает отсутствие активной сессии.

Значения перечисления:

idle

starting

streaming

reconnecting

ending

object · обязательно

Настройки по умолчанию церкви для следующего ручного запуска. Активная сессия не изменяет эти значения.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Пример тела запроса

{
  "deltaSeconds": 120
}

json

application/json

Примеры ответов

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Устройства Сессии