Fish Audio Docs
통합 가이드타사 통합
Back to site

Pipecat 설정

Fish Audio OpenAI 호환 엔드포인트와 함께 Pipecat OpenAITTSService를 사용하여 실시간 음성 에이전트를 구축하세요.

Fish Audio TTS를 Pipecat에 연결합니다.

Pipecat의 OpenAITTSService는 사용자 정의 base_url를 허용하므로 Fish Audio가 실시간 음성 파이프라인에서 음성을 제공할 수 있습니다.

설치 및 구성

uv add "pipecat-ai[openai]"
import os
from pipecat.services.openai import OpenAITTSService

tts = OpenAITTSService(
    api_key=os.environ["FISH_AUDIO_API_KEY"],
    base_url="https://fishaudio.org/v1",
    settings=OpenAITTSService.Settings(
        model="fishaudio-s21pro-flash",
        voice="00a1b221-6137-4b73-ad62-b0cbce134167",
        speed=1.0,
    ),
)

Pipecat 파이프라인에 tts를 추가하고 STT, LLM 및 중단 처리를 추가하기 전에 짧은 문장이 오디오 프레임으로 전송에 도달하는지 확인하세요.

오디오 고려사항

Pipecat의 OpenAI TTS 파이프라인은 24kHz PCM 오디오를 처리합니다. HTTP 200 검사에서 멈추지 마십시오. 결과를 듣고 샘플 속도, 채널 수 및 재생 속도를 확인하십시오.

문제 해결

  • 더 이상 사용되지 않는 매개변수 경고: 기존 최상위 모델 및 음성 인수 대신 OpenAITTSService.Settings를 사용하세요.
  • 빠르거나 느린 오디오: 전송 샘플 속도를 TTS 서비스에 맞춥니다.
  • 401/402: 서버측 환경 변수와 API 크레딧을 확인합니다.

관련 문서