Streamování

Stáhnout schéma

Poznámka: Koncový bod Start streaming lze použít pouze ke spuštění streamování ze zařízení Kaleo Connect. Tento koncový bod nelze použít ke spuštění streamování z webového prohlížeče. Všechny ostatní streamovací koncové body ovládají jak prohlížeč, tak zařízení Kaleo Connect.

Získat stav streamování

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Přečtěte si aktuální relaci a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

Získat stav streamování › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Získat stav streamování › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

Spustit streamování

POST

https://babel.withkaleo.com

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

Bearer (API key)

Spusťte streamování na zařízení Kaleo Connect pomocí uložených nastavení. Volitelné tělo může vybrat deviceId a přepsat nastavení pro tuto relaci. Bez deviceId Kaleo vybere výchozí zvukový zdroj nakonfigurovaný na stránce Kaleo Connect (v sekci Integrace) ve vašem dashboardu, pokud je k dispozici více zvukových zařízení, nebo jediný dostupný zvukový zdroj, pokud je k dispozici pouze jedno zařízení.

Spustit streamování › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Spustit streamování › Tělo požadavku volitelné

StartStreaming

deviceId

string

Volitelné ID zařízení zvukového zdroje z GET /devices. Přepisuje výchozí nastavení církve pro tuto relaci. Pokud je vynecháno, použije se uložený výchozí zvukový zdroj nebo jediné dostupné zařízení schopné zvuku; pokud je více zařízení bez výchozího, je vyžadován výběr. Vybrané zařízení musí být stále připraveno.

object

Nastavení pouze pro tuto relaci. Vynechaná pole používají uložené výchozí hodnoty.

Spustit streamování › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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 '{}'

Příklad těla požadavku

{}

json

application/json

Příklad odpovědí

{
  "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

Zastavit streamování

POST

https://babel.withkaleo.com

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

Bearer (API key)

Zastavte aktuální streamovací relaci. Není potřeba žádné tělo požadavku.

Zastavit streamování › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Zastavit streamování › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

Změnit hlas překladu

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Změňte hlas překladu během nečinnosti nebo streamování.

Změnit hlas překladu › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Změnit hlas překladu › Tělo požadavku

ChangeVoice

voice

string · enum · povinné

Hlas překladu. Lze měnit během nečinnosti nebo streamování.

Hodnoty výčtu:

male

female

Změnit hlas překladu › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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"
}'

Příklad těla požadavku

{
  "voice": "female"
}

json

application/json

Příklad odpovědí

{
  "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

Změnit viditelnost

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Zobrazit nebo skrýt titulky během nečinnosti nebo streamování. Skrytí titulků nezastaví relaci.

Změnit viditelnost › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Změnit viditelnost › Tělo požadavku

ChangeVisibility

visible

boolean · povinné

true zobrazuje titulky; false je skrývá, zatímco streamování pokračuje.

Změnit viditelnost › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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
}'

Příklad těla požadavku

{
  "visible": false
}

json

application/json

Příklad odpovědí

{
  "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

Vymazat titulky

POST

https://babel.withkaleo.com

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

Bearer (API key)

Vymažte aktuální titulkový proud. Není potřeba žádné tělo požadavku.

Vymazat titulky › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Vymazat titulky › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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

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

Příklad odpovědí

{
  "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

Změnit automatický čas ukončení

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Nastavte čas automatického ukončení pro aktivní relaci. Vrací aktualizovaný stav streamování.

Změnit automatický čas ukončení › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Změnit automatický čas ukončení › Tělo požadavku

ChangeDeadline

deadlineAt

string · date-time · povinné

Budoucí čas automatického ukončení s Z nebo časovým posunem. Ne později než šest hodin po startedAt.

Změnit automatický čas ukončení › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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"
}'

Příklad těla požadavku

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

json

application/json

Příklad odpovědí

{
  "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

Upravit čas automatického ukončení

POST

https://babel.withkaleo.com

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

Bearer (API key)

Přidat nebo odečíst čas automatického ukončení. Během nečinnosti změňte délku trvání pro další manuální spuštění. Během streamování změňte aktuální čas ukončení. Každý požadavek aplikuje samostatnou úpravu.

Upravit čas automatického ukončení › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Upravit čas automatického ukončení › Tělo požadavku

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · povinné

Sekundy k přidání k délce nečinnosti nebo aktuálnímu času ukončení; záporné hodnoty odečítají. Nemůže být 0. Délka nečinnosti: 60–21600 sekund. Živý čas ukončení: budoucí, do šesti hodin od startedAt.

Upravit čas automatického ukončení › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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
}'

Příklad těla požadavku

{
  "deltaSeconds": 120
}

json

application/json

Příklad odpovědí

{
  "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

Zařízení Relace

Kaleo API

Streamování

Stáhnout schéma

Získat stav streamování

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Přečtěte si aktuální relaci a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

Získat stav streamování › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Získat stav streamování › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

Spustit streamování

POST

https://babel.withkaleo.com

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

Bearer (API key)

Spustit streamování › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Spustit streamování › Tělo požadavku volitelné

StartStreaming

deviceId

string

object

Nastavení pouze pro tuto relaci. Vynechaná pole používají uložené výchozí hodnoty.

Spustit streamování › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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 '{}'

Příklad těla požadavku

{}

json

application/json

Příklad odpovědí

{
  "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

Zastavit streamování

POST

https://babel.withkaleo.com

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

Bearer (API key)

Zastavte aktuální streamovací relaci. Není potřeba žádné tělo požadavku.

Zastavit streamování › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Zastavit streamování › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

Změnit hlas překladu

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Změňte hlas překladu během nečinnosti nebo streamování.

Změnit hlas překladu › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Změnit hlas překladu › Tělo požadavku

ChangeVoice

voice

string · enum · povinné

Hlas překladu. Lze měnit během nečinnosti nebo streamování.

Hodnoty výčtu:

male

female

Změnit hlas překladu › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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"
}'

Příklad těla požadavku

{
  "voice": "female"
}

json

application/json

Příklad odpovědí

{
  "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

Změnit viditelnost

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Zobrazit nebo skrýt titulky během nečinnosti nebo streamování. Skrytí titulků nezastaví relaci.

Změnit viditelnost › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Změnit viditelnost › Tělo požadavku

ChangeVisibility

visible

boolean · povinné

true zobrazuje titulky; false je skrývá, zatímco streamování pokračuje.

Změnit viditelnost › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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
}'

Příklad těla požadavku

{
  "visible": false
}

json

application/json

Příklad odpovědí

{
  "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

Vymazat titulky

POST

https://babel.withkaleo.com

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

Bearer (API key)

Vymažte aktuální titulkový proud. Není potřeba žádné tělo požadavku.

Vymazat titulky › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Vymazat titulky › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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

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

Příklad odpovědí

{
  "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

Změnit automatický čas ukončení

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Nastavte čas automatického ukončení pro aktivní relaci. Vrací aktualizovaný stav streamování.

Změnit automatický čas ukončení › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Změnit automatický čas ukončení › Tělo požadavku

ChangeDeadline

deadlineAt

string · date-time · povinné

Budoucí čas automatického ukončení s Z nebo časovým posunem. Ne později než šest hodin po startedAt.

Změnit automatický čas ukončení › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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"
}'

Příklad těla požadavku

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

json

application/json

Příklad odpovědí

{
  "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

Upravit čas automatického ukončení

POST

https://babel.withkaleo.com

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

Bearer (API key)

Upravit čas automatického ukončení › Parametry cesty

churchId

string · povinné

ID vaší církve. Zkopírujte jej ze stránky API (v sekci Integrace) ve vašem dashboardu.

Upravit čas automatického ukončení › Tělo požadavku

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · povinné

Upravit čas automatického ukončení › Odpovědi

Úspěch

Aktuální relace a sdílená nastavení církve. Všechna pole jsou přítomna, i když je nečinná.

StreamingStatus

streaming

boolean · povinné

true během aktivní relace, včetně spuštění, znovupřipojení a ukončení. Nepotvrzuje příjem zvuku.

sessionId

string | null · povinné

Aktuální ID relace; null během nečinnosti.

startedAt

string | null · date-time · povinné

Čas zahájení aktuální relace; null během nečinnosti.

deadlineAt

string | null · date-time · povinné

Čas automatického ukončení; null během nečinnosti nebo pokud není zaznamenán čas ukončení.

speakerLanguage

string | null · povinné

Aktuální jazykový kód řečníka; null během nečinnosti.

targetLanguages

string[] · povinné

Aktuální kódy překladových jazyků; prázdné během nečinnosti.

voice

string · enum · povinné

Hlas překladu, včetně během nečinnosti.

Hodnoty výčtu:

male

female

visible

boolean · povinné

true zobrazuje titulky; false je skrývá. Platí také během nečinnosti.

publisher

object | null · povinné

Zařízení Kaleo Connect nebo prohlížeč, který odesílá zvuk; null během nečinnosti.

phase

string · enum · povinné

Fáze relace; nečinnost znamená, že žádná relace není aktivní.

Hodnoty výčtu:

idle

starting

streaming

reconnecting

ending

object · povinné

Výchozí nastavení církve pro další manuální spuštění. Přepisy aktivní relace tyto hodnoty nemění.

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
}'

Příklad těla požadavku

{
  "deltaSeconds": 120
}

json

application/json

Příklad odpovědí

{
  "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

Zařízení Relace