Fish Audio 文档
集成指南第三方软件接入

Coze 接入教程

在 Coze 工作流中调用 Fish Audio 的 OpenAI 兼容 TTS API,把机器人文本回复转换成语音文件。

Coze 接入 Fish Audio TTS

在 Coze 工作流中使用 HTTP 请求节点,可以把机器人生成的文本转换成 Fish Audio 语音。该接口采用 OpenAI 兼容的 TTS 请求格式。

准备工作

  1. 创建一个独立的 Fish Audio API Key;
  2. 从声音库复制一个 Fish Audio 音色 ID;
  3. 创建或打开一个接收文本输入的 Coze 工作流。

配置 HTTP 请求

在文本生成节点后添加 HTTP 请求节点,并填写以下配置:

配置项
请求方法POST
URLhttps://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;
  • 请求超时:先缩短输入文本,每次请求建议只处理一个段落。

相关文档