서버 측 스트리밍
이 가이드에서는 ElevenLabs를 사용해 서버 측에서 실시간으로 오디오를 전사하는 방법을 알아봅니다.
방법 가이드 · Speech to Text 빠른 시작을 완료했다고 가정합니다.
개요
ElevenLabs Realtime Speech to Text API를 사용하면 Scribe Realtime v2 모델로 초저지연 실시간 오디오 스트림 전사를 수행할 수 있습니다. 음성 어시스턴트, 전사 서비스 또는 실시간 음성 인식이 필요한 모든 애플리케이션을 구축할 때, 이 WebSocket 기반 API는 말하는 동안 부분 전사를 제공하고 음성 세그먼트가 완료되면 커밋된 전사를 제공합니다.
Scribe v3 Live는 URL, 파일 또는 자체 오디오 스트림을 통해 서버 측에서 구현하여 오디오를 실시간으로 전사할 수 있습니다.
서버 측 구현은 클라이언트 측과 몇 가지 차이점이 있습니다.
- 일회용 토큰 대신 ElevenLabs API 키를 사용합니다.
- 오디오를 수동으로 청크 처리할 필요 없이 URL에서 직접 스트리밍을 지원합니다.
마이크에서 직접 오디오를 스트리밍하려면 클라이언트 측 스트리밍 가이드를 참조하세요.
빠른 시작
이 가이드에서는 API 키 및 SDK를 설정했다고 가정합니다. 아직 완료하지 않았다면 먼저 빠른 시작을 완료하세요.
SDK 구성
SDK는 실시간으로 오디오를 전사하는 두 가지 방법을 제공합니다. URL에서 스트리밍하거나 파일 또는 자체 오디오 스트림의 오디오를 수동으로 청크 처리하는 방법입니다.
API가 지원하는 전체 파라미터 및 옵션 목록은 API 레퍼런스를 참조하세요.
URL에서 스트리밍
수동 오디오 청크 처리
이 예제에서는 공식 SDK를 사용하여 URL에서 오디오 파일을 스트리밍하는 방법을 보여 줍니다.
URL에서 스트리밍할 때는 ffmpeg 도구가 필요합니다. 설치 방법은 웹사이트를 방문해 확인하세요.
선택한 언어에 따라 example.py 또는 example.mts라는 새 파일을 만들고 다음 코드를 추가하세요.