LiveKit

LiveKit에서 Fish Audio로 만드는 실시간 음성 에이전트

Fish Audio 텍스트 음성 변환은 LiveKit Agents의 공식 플러그인과 LiveKit Inference를 통해 제공됩니다. 에이전트가 대화 수준의 지연 시간으로 Fish Audio의 가장 표현력 있는 목소리로 말할 수 있습니다.

카테고리실시간 인프라
연동 방식LiveKit Agents 플러그인(Python) 및 LiveKit Inference
스트리밍청크 합성 및 실시간 WebSocket
기본 모델Fish Audio S2.1 Pro
음성reference_id로 모든 Fish Audio 음성 또는 클론 사용
docs.livekit.io ↗

LiveKit와 Fish Audio를 함께 쓰는 이유

LiveKit은 실시간 전송, 턴 감지, 에이전트 오케스트레이션을 담당하고 Fish Audio는 에이전트의 목소리를 담당합니다. 둘을 함께 쓰면 프로토타입에서 프로덕션 음성 에이전트까지 가장 빠르게 갈 수 있습니다.

두 가지 실행 방식

LiveKit Inference를 사용하면 별도의 공급자 API 키 없이 LiveKit 인프라에서 Fish Audio를 실행할 수 있고, 플러그인을 설치하면 Fish Audio 요금과 사용량 제한을 직접 관리할 수 있습니다.

턴테이킹을 위한 스트리밍

플러그인은 청크 합성과 실시간 WebSocket 스트리밍을 지원하므로, 전체 응답을 기다리지 않고 첫 토큰이 도착하자마자 말하기 시작합니다.

모든 Fish Audio 음성을 에이전트별로 조정

reference_id를 Fish Audio 라이브러리의 음성이나 직접 만든 클론으로 지정하고, 에이전트마다 속도, 볼륨, temperature, top_p를 설정하세요.

사용 방법

Fish Audio 음성을 LiveKit 위의 실제 제품으로 출시하기까지 3단계.

STEP 01

플러그인 설치

extra 하나만 추가하면 LiveKit Agents에 Fish Audio가 들어갑니다.

pip install "livekit-agents[fishaudio]"
STEP 02

API 키 설정

에이전트 환경에서 FISH_API_KEY를 export하세요. LiveKit Inference를 쓰면 이 단계는 건너뛸 수 있습니다.

API 키 발급
.env
12345678
FISH_API_KEY=your_api_key

API 키 발급

API 키 발급
STEP 03

에이전트에 TTS 추가

TTS 클래스를 import하고 음성과 모델을 고른 뒤 AgentSession에 넘기세요. 실시간 스트리밍은 플래그 하나면 됩니다.

agent.py
1234567
from livekit.plugins.fishaudio import TTS
tts = TTS(
    reference_id="your_voice_model_id",
    model="s2.1-pro",
    sample_rate=24000,
    latency_mode="balanced",
)

Fish Audio와 LiveKit로 팀들이 만드는 것

헤드셋을 쓰고 노트북 앞에서 통화하는 상담원

고객 지원 에이전트

실시간으로 응대하고 분류하고 해결하는 음성 에이전트. 모든 통화에서 일관된 브랜드 목소리를 유지합니다.

테이블에 앉아 있는 판타지 일러스트 캐릭터

컴패니언과 캐릭터

게임, 컴패니언, 인터랙티브 캐릭터를 위한 표현력 있고 감정 조절이 가능한 음성.

헤드셋을 쓰고 노트북으로 일하는 남성
헤드셋을 쓰고 통화하는 여성
안경과 헤드셋을 쓰고 책상에 앉은 여성

다국어 어시스턴트

하나의 에이전트로 여러 시장을. Fish Audio 음성은 하나의 LiveKit 파이프라인에서 세계 주요 언어를 지원합니다.

Fish Audio와 LiveKit로 개발을 시작하세요

LiveKit 연동 가이드를 읽거나, 공동 마케팅과 공동 고객에 대해 파트너십 팀과 이야기해 보세요.