集成指南
接口选择
选择合适的 FishSpeech Open API 形态。
接口选择
FishSpeech 的 Open API 位于 /api/open/v1。多数集成从文字转语音开始，再按需要加入异步任务、音色管理、语音转写或口型同步。
| API | 适用场景 | 响应 |
|---|---|---|
POST /speech/tts | 短文本和快速接入测试 | 音频二进制或缓存音频元数据 |
POST /speech/tts/jobs | 长文本或任务制工作流 | 先返回任务，再轮询结果 |
POST /speech/transcriptions | 转写已有音频 | 转写 JSON |
GET /voices | 选择可用音色 | 音色列表 JSON |
POST /media/lip-sync/jobs | 创建口型同步视频任务 | 任务 envelope JSON |
建议
首次接入从同步 TTS 开始：
POST /api/open/v1/speech/tts当文本较长、用户可以等待，或需要任务对账时，使用异步 TTS：
POST /api/open/v1/speech/tts/jobs
GET /api/open/v1/speech/tts/jobs/{taskId}手动测试请求时使用 API Playground：
/zh/api-playground