集成指南第三方软件接入
Coze 接入教程
在 Coze 工作流中调用 Fish Audio 的 OpenAI 兼容 TTS API,把机器人文本回复转换成语音文件。
Coze 接入 Fish Audio TTS
在 Coze 工作流中使用 HTTP 请求节点,可以把机器人生成的文本转换成 Fish Audio 语音。该接口采用 OpenAI 兼容的 TTS 请求格式。
准备工作
- 创建一个独立的 Fish Audio API Key;
- 从声音库复制一个 Fish Audio 音色 ID;
- 创建或打开一个接收文本输入的 Coze 工作流。
配置 HTTP 请求
在文本生成节点后添加 HTTP 请求节点,并填写以下配置:
| 配置项 | 值 |
|---|---|
| 请求方法 | POST |
| URL | https://fishaudio.org/v1/audio/speech |
| 请求头 | Authorization: Bearer YOUR_FISH_AUDIO_API_KEY |
| 请求头 | Content-Type: application/json |
请求体使用以下 JSON:
{
"model": "fishaudio-s21pro-flash",
"voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
"input": "{{text}}",
"response_format": "mp3"
}把 {{text}} 映射到保存机器人回复的工作流变量。将节点响应配置为文件或二进制输出,再由工作流输出该文件。
测试工作流
先用一句短文本运行工作流。确认 HTTP 节点能返回 MP3 文件后,再把工作流连接到已发布的机器人或应用。
常见问题
- 401:检查 Authorization 请求头是否以
Bearer开头,并使用 Fish Audio API Key; - 402:购买 API 积分;会员积分和 API 积分是两个独立余额;
- 没有音频输出:把 HTTP 响应类型配置为文件或二进制,而不是 JSON;
- 音色无效:把示例音色 ID 替换为有效的系统音色或自定义音色 ID;
- 请求超时:先缩短输入文本,每次请求建议只处理一个段落。