Streaming

Télécharger le schéma

Remarque : le point de terminaison Démarrer le streaming ne peut être utilisé que pour démarrer le streaming depuis un appareil Kaleo Connect. Ce point de terminaison ne peut pas être utilisé pour démarrer le streaming depuis un navigateur web. Tous les autres points de terminaison de streaming contrôlent à la fois les navigateurs et les appareils Kaleo Connect.

Obtenir le statut du streaming

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Lire la session en cours et les paramètres partagés de l'église. Tous les champs sont présents, même en veille.

Obtenir le statut du streaming › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Obtenir le statut du streaming › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

Démarrer le streaming

POST

https://babel.withkaleo.com

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

Bearer (API key)

Démarrez le streaming sur un appareil Kaleo Connect en utilisant les paramètres enregistrés. Le corps optionnel peut sélectionner un deviceId et remplacer les paramètres pour cette session. Sans deviceId, Kaleo choisit la source audio par défaut configurée sur la page Kaleo Connect (sous Intégrations) dans votre tableau de bord s'il y a plusieurs appareils audio disponibles, ou la seule source audio disponible si un seul appareil est disponible.

Démarrer le streaming › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Démarrer le streaming › Corps de la requête optionnel

StartStreaming

deviceId

string

ID optionnel de l'appareil source audio depuis GET /devices. Remplace la valeur par défaut de l'église pour cette session. Si omis, utilise la source audio par défaut enregistrée ou l'unique appareil couplé capable d'audio ; plusieurs appareils sans valeur par défaut nécessitent une sélection. L'appareil sélectionné doit être prêt.

object

Paramètres uniquement pour cette session. Les champs omis utilisent les valeurs par défaut enregistrées.

Démarrer le streaming › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{}

json

application/json

Exemples de réponses

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

Arrêter le streaming

POST

https://babel.withkaleo.com

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

Bearer (API key)

Arrêtez la session de streaming en cours. Aucun corps de requête n'est nécessaire.

Arrêter le streaming › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Arrêter le streaming › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

Changer la voix de traduction

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Changer la voix de traduction pendant que le système est en veille ou en streaming.

Changer la voix de traduction › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Changer la voix de traduction › Corps de la requête

ChangeVoice

voice

string · enum · requis

Voix de traduction. Peut changer en veille ou en streaming.

Valeurs de l'énumération :

male

female

Changer la voix de traduction › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{
  "voice": "female"
}

json

application/json

Exemples de réponses

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

Changer la visibilité

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Afficher ou masquer les sous-titres pendant que le système est en veille ou en streaming. Masquer les sous-titres ne stoppe pas la session.

Changer la visibilité › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Changer la visibilité › Corps de la requête

ChangeVisibility

visible

boolean · requis

true affiche les sous-titres ; false les masque pendant que le streaming continue.

Changer la visibilité › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{
  "visible": false
}

json

application/json

Exemples de réponses

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

Effacer les sous-titres

POST

https://babel.withkaleo.com

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

Bearer (API key)

Effacez le flux de sous-titres actuel. Aucun corps de requête n'est nécessaire.

Effacer les sous-titres › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Effacer les sous-titres › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

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

Exemples de réponses

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

Changer la date limite d'arrêt automatique

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Définissez l'heure d'arrêt automatique pour une session active. Renvoie le statut de streaming mis à jour.

Changer la date limite d'arrêt automatique › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Changer la date limite d'arrêt automatique › Corps de la requête

ChangeDeadline

deadlineAt

string · date-time · requis

Heure future d'arrêt automatique avec Z ou un décalage horaire. Pas plus tard que six heures après startedAt.

Changer la date limite d'arrêt automatique › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

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

json

application/json

Exemples de réponses

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

Ajuster l'heure d'arrêt automatique

POST

https://babel.withkaleo.com

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

Bearer (API key)

Ajouter ou soustraire du temps d'arrêt automatique. En veille, modifiez la durée pour le prochain démarrage manuel. En streaming, modifiez la date limite actuelle. Chaque requête applique un ajustement séparé.

Ajuster l'heure d'arrêt automatique › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Ajuster l'heure d'arrêt automatique › Corps de la requête

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · requis

Secondes à ajouter à la durée en veille ou à la date limite actuelle ; les valeurs négatives soustraient. Ne peut pas être 0. Durée en veille : 60–21600 secondes. Date limite en direct : future, dans les six heures suivant startedAt.

Ajuster l'heure d'arrêt automatique › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{
  "deltaSeconds": 120
}

json

application/json

Exemples de réponses

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

Appareils Sessions

API Kaleo

Streaming

Télécharger le schéma

Obtenir le statut du streaming

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Lire la session en cours et les paramètres partagés de l'église. Tous les champs sont présents, même en veille.

Obtenir le statut du streaming › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Obtenir le statut du streaming › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

Démarrer le streaming

POST

https://babel.withkaleo.com

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

Bearer (API key)

Démarrer le streaming › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Démarrer le streaming › Corps de la requête optionnel

StartStreaming

deviceId

string

object

Paramètres uniquement pour cette session. Les champs omis utilisent les valeurs par défaut enregistrées.

Démarrer le streaming › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{}

json

application/json

Exemples de réponses

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

Arrêter le streaming

POST

https://babel.withkaleo.com

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

Bearer (API key)

Arrêtez la session de streaming en cours. Aucun corps de requête n'est nécessaire.

Arrêter le streaming › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Arrêter le streaming › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

Changer la voix de traduction

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Changer la voix de traduction pendant que le système est en veille ou en streaming.

Changer la voix de traduction › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Changer la voix de traduction › Corps de la requête

ChangeVoice

voice

string · enum · requis

Voix de traduction. Peut changer en veille ou en streaming.

Valeurs de l'énumération :

male

female

Changer la voix de traduction › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{
  "voice": "female"
}

json

application/json

Exemples de réponses

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

Changer la visibilité

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Afficher ou masquer les sous-titres pendant que le système est en veille ou en streaming. Masquer les sous-titres ne stoppe pas la session.

Changer la visibilité › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Changer la visibilité › Corps de la requête

ChangeVisibility

visible

boolean · requis

true affiche les sous-titres ; false les masque pendant que le streaming continue.

Changer la visibilité › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{
  "visible": false
}

json

application/json

Exemples de réponses

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

Effacer les sous-titres

POST

https://babel.withkaleo.com

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

Bearer (API key)

Effacez le flux de sous-titres actuel. Aucun corps de requête n'est nécessaire.

Effacer les sous-titres › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Effacer les sous-titres › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

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

Exemples de réponses

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

Changer la date limite d'arrêt automatique

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

Définissez l'heure d'arrêt automatique pour une session active. Renvoie le statut de streaming mis à jour.

Changer la date limite d'arrêt automatique › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Changer la date limite d'arrêt automatique › Corps de la requête

ChangeDeadline

deadlineAt

string · date-time · requis

Heure future d'arrêt automatique avec Z ou un décalage horaire. Pas plus tard que six heures après startedAt.

Changer la date limite d'arrêt automatique › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

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

json

application/json

Exemples de réponses

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

Ajuster l'heure d'arrêt automatique

POST

https://babel.withkaleo.com

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

Bearer (API key)

Ajuster l'heure d'arrêt automatique › Paramètres de chemin

churchId

string · requis

L'ID de votre église. Copiez-le depuis la page API (sous Intégrations) dans votre tableau de bord.

Ajuster l'heure d'arrêt automatique › Corps de la requête

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · requis

Ajuster l'heure d'arrêt automatique › Réponses

Succès

Session actuelle et paramètres partagés de l'église. Tous les champs sont présents, même en veille.

StreamingStatus

streaming

boolean · requis

true pendant une session active, y compris démarrage, reconnexions et arrêt. Ne confirme pas que l'audio arrive.

sessionId

string | null · requis

ID de la session en cours ; null en veille.

startedAt

string | null · date-time · requis

Heure de début de la session en cours ; null en veille.

deadlineAt

string | null · date-time · requis

Heure d'arrêt automatique ; null en veille ou si aucune date limite enregistrée.

speakerLanguage

string | null · requis

Code de langue du locuteur actuel ; null en veille.

targetLanguages

string[] · requis

Codes des langues de traduction actuelles ; vide en veille.

voice

string · enum · requis

Voix de traduction, y compris en veille.

Valeurs de l'énumération :

male

female

visible

boolean · requis

true affiche les sous-titres ; false les masque. S'applique aussi en veille.

publisher

object | null · requis

Appareil Kaleo Connect ou navigateur qui envoie l'audio ; null en veille.

phase

string · enum · requis

Étape de la session ; veille signifie qu'aucune session n'est active.

Valeurs de l'énumération :

idle

starting

streaming

reconnecting

ending

object · requis

Paramètres par défaut de l'église pour le prochain démarrage manuel. Les sessions actives ne modifient pas ces valeurs.

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

Exemple de corps de requête

{
  "deltaSeconds": 120
}

json

application/json

Exemples de réponses

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

Appareils Sessions