集成指南第三方软件接入
LiveKit Agents 接入教程
在 LiveKit Agents 的 OpenAI TTS Plugin 中配置 Fish Audio Base URL、模型和音色。
LiveKit Agents 接入 Fish Audio TTS
LiveKit Agents 的 OpenAI Plugin 允许覆盖 TTS 的 base_url、API Key、模型和音色，适合实时语音助手、客服和电话 Agent。
Python 配置
import os
from livekit.agents import AgentSession
from livekit.plugins import openai
session = AgentSession(
tts=openai.TTS(
api_key=os.environ["FISH_AUDIO_API_KEY"],
base_url="https://fishaudio.org/v1",
model="fishaudio-s21pro-flash",
voice="00a1b221-6137-4b73-ad62-b0cbce134167",
),
)安装依赖：
uv add "livekit-agents[openai]~=1.5"Node.js 配置
import { AgentSession } from '@livekit/agents';
import * as openai from '@livekit/agents-plugin-openai';
const session = new AgentSession({
tts: new openai.TTS({
apiKey: process.env.FISH_AUDIO_API_KEY!,
baseURL: 'https://fishaudio.org/v1',
model: 'fishaudio-s21pro-flash',
voice: '00a1b221-6137-4b73-ad62-b0cbce134167',
}),
});先用短句测试端到端音频，再接入 SIP、WebRTC 或前端。API Key 只能保存在 Agent 服务端。
常见问题
- 类型限制 voice：LiveKit 新版本允许使用字符串音色 ID；若类型包过旧，请升级插件。
- 没有声音但请求成功：检查音频管线采样率和输出设备，而不只检查 HTTP 状态。
- 401/402：检查环境变量和 API 积分。