실시간 전사 API는 무엇을 하나요?
실시간 전사 API는 앱이 보내는 오디오를 받아 전사 결과를 바로 돌려줘요. 세션을 만들 때 번역 언어를 지정하면 번역 결과도 함께 받아요. 결과는 WebSocket 메시지로만 전달해요. Tiro는 이 API로 노트를 만들지 않고 받은 오디오를 보관하지 않아요. 전사와 번역 텍스트를 나중에 다시 조회하는 API도 없으니, 필요한 결과는 받는 쪽에서 저장하세요.어떤 순서로 동작하나요?
실시간 전사는 REST로 세션을 만들고, WebSocket으로 오디오를 보내고 결과를 받아요. API Key는 고객 서버에만 두고, 클라이언트에는 세션마다 발급되는streamToken만 넘겨요.
연결이 끊겨도 세션이 열려 있으면 같은 토큰으로 다시 연결해 이어 갈 수 있어요. 규칙은 재접속에 있어요.
누가 쓸 수 있나요?
아래 세 조건을 모두 갖춰야 세션을 만들 수 있어요.
조직 API Key와 OAuth 액세스 토큰으로는 이 API를 호출할 수 없어요. Scope는 인증에서 자세히 설명해요.
어떤 제한이 있나요?
어떤 언어를 지원하나요?
전사와 번역 모두 지원 로케일의 17개 로케일을 지원해요. 세션을 만들 때transcriptionLocale을 생략하거나 AUTO로 보내면 Tiro가 말하는 언어를 자동으로 감지해요. translationLocale은 하나만 지정할 수 있고 자동 감지를 쓸 수 없어요.
번역은 원문 문장과 1:1로 짝지어 오지 않아요. 번역 조각을 도착한 순서대로 이어 붙여 보여 주세요. 규칙은 translation 메시지에 있어요.
이 API가 제공하지 않는 것은 무엇인가요?
지금 버전은 아래 기능을 제공하지 않아요.- 화자 구분, 단어나 문장 단위 타임스탬프
- 노트 생성과 웹훅
- 오디오 보관과 재전송. 연결이 끊긴 동안의 오디오는 클라이언트가 모아 두었다가 다시 보내야 해요
- 브라우저에서 직접 연결. 브라우저 WebSocket API는
Authorization헤더를 보낼 수 없으니 서버나 네이티브 앱에서 연결하세요
사용량은 어떻게 기록되나요?
Tiro는 세션마다 받은 오디오 길이와 연결 시간을 기록해요. 받은 오디오 길이는 세션 조회 응답과session.ended 메시지의 audioDurationMs로 확인해요. 이 사용량은 노트 녹음 사용량이나 워크스페이스 사용 한도에 더하지 않아요. 요금은 엔터프라이즈 계약에서 정해요.
다음 단계
빠른 시작
세션을 만들고 오디오 파일을 보내 결과를 받아 보세요.
WebSocket 프로토콜
메시지 필드, 재접속, 에러와 close code를 확인하세요.