集成指南
接口选择
选择合适的 Fish Audio API 形态。
接口选择
Fish Audio 在 /api/open/v1 下提供统一 Open API。多数集成从文字转语音开始，再按需要加入异步任务、音色管理、语音转文字或口型同步。
| API | 适用场景 | 响应 |
|---|---|---|
POST /speech/tts | 短文本和快速接入测试 | 音频二进制或缓存音频信息 |
POST /speech/tts/jobs | 长文本或任务制工作流 | 先返回任务，再轮询结果 |
WS /v2/tts/live | 低延迟流式 TTS | MessagePack 音频事件 |
POST /speech/transcriptions | 转写已有音频 | 转写 JSON |
GET /voices | 选择可用音色 | 音色列表 JSON |
POST /media/lip-sync/jobs | 创建口型同步视频任务 | 口型同步异步任务的 JSON 信息 |
建议
首次接入从同步 TTS 开始：
POST /api/open/v1/speech/tts当文本较长、用户可以等待，或需要任务对账时，使用异步 TTS：
POST /api/open/v1/speech/tts/jobs
GET /api/open/v1/speech/tts/jobs/{taskId}需要在完整文本流程结束前开始播放音频时，使用实时 TTS v2：
wss://realtime.fishaudio.org/v2/tts/live
Sec-WebSocket-Protocol: realtime.tts.msgpack.v2手动测试请求时使用 API 调试台：
https://fishaudio.org/zh/api-playground