스트리밍

스키마 다운로드

시작 스트리밍 엔드포인트는 Kaleo Connect 장치에서만 스트리밍 시작에 사용할 수 있습니다. 이 엔드포인트는 웹 브라우저에서 스트리밍 시작에 사용할 수 없습니다. 다른 모든 스트리밍 엔드포인트는 브라우저와 Kaleo Connect 장치를 모두 제어합니다.

스트리밍 상태 조회

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

현재 세션 및 공유 교회 설정을 읽습니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

스트리밍 상태 조회 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 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

starting

streaming

reconnecting

ending

object · 필수

다음 수동 시작을 위한 교회 기본값입니다. 활성 세션 재정의는 이 값을 변경하지 않습니다.

스트리밍 시작

POST

https://babel.withkaleo.com

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

Bearer (API key)

저장된 설정을 사용하여 Kaleo Connect 장치에서 스트리밍을 시작합니다. 선택적 본문은 deviceId를 선택하고 이 세션에 대한 설정을 재정의할 수 있습니다. deviceId이 없으면, Kaleo는 대시보드의 통합(Integrations) 아래 Kaleo Connect 페이지에서 구성된 기본 오디오 소스를 선택합니다. 여러 오디오 지원 장치가 있으면 기본값을 사용하거나, 하나만 있으면 해당 장치를 사용합니다.

스트리밍 시작 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

스트리밍 시작 › 요청 본문 선택 사항

StartStreaming

deviceId

string

선택적 오디오 소스 장치 ID로, GET /devices에서 가져옵니다. 이 세션에 대해 교회 기본값을 재정의합니다. 생략하면 저장된 기본 오디오 소스 또는 단일 오디오 소스 지원 장치를 사용합니다. 여러 장치가 있고 기본값이 없으면 선택이 필요합니다. 선택한 장치는 준비되어 있어야 합니다.

object

이 세션에만 적용되는 설정입니다. 생략된 필드는 저장된 기본값을 사용합니다.

스트리밍 시작 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 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

starting

streaming

reconnecting

ending

object · 필수

다음 수동 시작을 위한 교회 기본값입니다. 활성 세션 재정의는 이 값을 변경하지 않습니다.

번역 음성 변경

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

유휴 상태 또는 스트리밍 중에 번역 음성을 변경합니다.

번역 음성 변경 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

번역 음성 변경 › 요청 본문

ChangeVoice

voice

string · enum · 필수

번역 음성입니다. 유휴 또는 스트리밍 중에 변경할 수 있습니다.

열거형 값:

male

female

번역 음성 변경 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

가시성 변경 › 요청 본문

ChangeVisibility

visible

boolean · 필수

true는 자막을 표시하고; false는 스트리밍을 계속하면서 자막을 숨깁니다.

가시성 변경 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 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

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입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

자동 중지 기한 변경 › 요청 본문

ChangeDeadline

deadlineAt

string · date-time · 필수

Z 또는 시간대 오프셋이 포함된 미래 자동 중지 시간입니다. startedAt 이후 6시간 이내여야 합니다.

자동 중지 기한 변경 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

자동 중지 시간 조정 › 요청 본문

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · 필수

유휴 지속 시간 또는 현재 기한에 더할 초 단위 값입니다; 음수는 빼기입니다. 0일 수 없습니다. 유휴 지속 시간: 60–21600초. 라이브 기한: startedAt 이후 6시간 이내의 미래.

자동 중지 시간 조정 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 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

starting

streaming

reconnecting

ending

object · 필수

다음 수동 시작을 위한 교회 기본값입니다. 활성 세션 재정의는 이 값을 변경하지 않습니다.

스트리밍 시작

POST

https://babel.withkaleo.com

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

Bearer (API key)

스트리밍 시작 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

스트리밍 시작 › 요청 본문 선택 사항

StartStreaming

deviceId

string

object

이 세션에만 적용되는 설정입니다. 생략된 필드는 저장된 기본값을 사용합니다.

스트리밍 시작 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 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

starting

streaming

reconnecting

ending

object · 필수

다음 수동 시작을 위한 교회 기본값입니다. 활성 세션 재정의는 이 값을 변경하지 않습니다.

번역 음성 변경

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

유휴 상태 또는 스트리밍 중에 번역 음성을 변경합니다.

번역 음성 변경 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

번역 음성 변경 › 요청 본문

ChangeVoice

voice

string · enum · 필수

번역 음성입니다. 유휴 또는 스트리밍 중에 변경할 수 있습니다.

열거형 값:

male

female

번역 음성 변경 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

가시성 변경 › 요청 본문

ChangeVisibility

visible

boolean · 필수

true는 자막을 표시하고; false는 스트리밍을 계속하면서 자막을 숨깁니다.

가시성 변경 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 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

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입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

자동 중지 기한 변경 › 요청 본문

ChangeDeadline

deadlineAt

string · date-time · 필수

Z 또는 시간대 오프셋이 포함된 미래 자동 중지 시간입니다. startedAt 이후 6시간 이내여야 합니다.

자동 중지 기한 변경 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

자동 중지 시간 조정 › 요청 본문

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · 필수

자동 중지 시간 조정 › 응답

성공

현재 세션 및 공유 교회 설정입니다. 모든 필드가 포함되며, 유휴 상태에서도 포함됩니다.

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

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

장치 세션