集成指南第三方软件接入
Pipecat 接入教程
使用 Pipecat OpenAITTSService 和 Fish Audio OpenAI 兼容接口构建实时语音机器人。
Pipecat 接入 Fish Audio TTS
Pipecat 的 OpenAITTSService 支持自定义 base_url，可以把 Fish Audio 作为实时语音管线中的 TTS 服务。
安装和配置
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,
),
)把 tts 放入 Pipecat Pipeline，并先用一句短文本验证音频帧能够进入 Transport。确认后再接入 STT、LLM 和打断逻辑。
音频注意事项
Pipecat 的 OpenAI TTS 管线按 24kHz PCM 处理音频。测试时不仅要确认接口返回 200，还要实际收听，检查采样率、声道数和播放速度。
常见问题
- 参数已弃用警告：使用
OpenAITTSService.Settings，不要继续使用旧版顶层model和voice参数。 - 音频变速或噪声：检查 Transport 的采样率是否与 TTS Service 一致。
- 401/402：检查服务端环境变量和 API 积分。