语音合成

声音克隆

对口型视频

其他

语音合成 — 多人剧本 TTS

使用多角色剧本生成单个多人配音音频。

多人剧本文字转语音

POST /api/open/v1/speech/tts/multi-script。传入说话人音色 ID 与有序台词，生成单个多人配音音频。该接口仅支持 FishAudio S2 Pro 音色。

接口地址

POST /api/open/v1/speech/tts/multi-script

请求头

Content-Type
stringheader必填
application/json
Authorization
stringheader必填
Bearer <token> (API Key)

请求参数

application/json
speakers
array必填
至少 2 个说话人。每项为 { name, voiceId }
lines
array必填
有序台词。每项为 { speakerName, text, order }
format
string可选默认: mp3
mp3 | wav
可选项：mp3wav
cache
boolean可选
false 返回音频流；true 缓存并返回 audio_url
speed
number可选默认: 1
语速 0.5-2.0
volume
number可选默认: 0
音量 -20~20
stability
number可选默认: 1
0.5-1.5
similarity
number可选默认: 1
0.5-1.5
language
string可选
语言提示，如 en、zh、ru
token
string // 可选，已使用 Authorization: Bearer 时可省略

返回数据

// cache=false 成功响应 - 200
Content-Type: audio/mpeg（或根据 format 返回 audio/wav）
X-OpenAPI-Credits-Used: number
X-OpenAPI-Quota-Remaining: number
X-Request-Id: string
<Binary audio data>

// cache=true 成功响应 - 200
{
  "success": true,
  "audio_url": string,
  "format": "mp3" | "wav",
  "characters_used": number,
  "credits_used": number,
  "quota_remaining": number,
  "expires_at": string
}

// 错误响应
{
  "code": string,
  "message": string,
  "requestId"?: string,
  "remaining_quota"?: number,
  "required_quota"?: number
}

CURL 示例

curl -X POST https://fishaudio.org/api/open/v1/speech/tts/multi-script \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "speakers": [
    {
      "name": "主持人",
      "voiceId": "d094a1df-fe4f-40d9-961a-99c361eaab6c"
    },
    {
      "name": "嘉宾",
      "voiceId": "93100ea8-8d9e-4898-8678-3b7714332c60"
    }
  ],
  "lines": [
    {
      "speakerName": "主持人",
      "text": "欢迎收听今天的产品更新。",
      "order": 0
    },
    {
      "speakerName": "嘉宾",
      "text": "今天我们介绍多人剧本 TTS API。",
      "order": 1
    }
  ],
  "format": "mp3",
  "cache": false,
  "speed": 1,
  "volume": 0,
  "stability": 1,
  "similarity": 1,
  "language": "zh"
}' \
  --output multi-script.mp3

在线调试

状态码说明

状态码说明：
200 OK                  - 请求成功
400 Bad Request         - 请求参数错误
401 Unauthorized        - API Token 无效
403 Forbidden          - 禁止访问
404 Not Found          - 资源不存在
413 Payload Too Large  - 上传文件过大
429 Too Many Requests  - 请求频率超限/积分不足
500 Server Error       - 服务器内部错误

错误响应格式：
{
  "error": string,      // 错误信息
  "details": string,    // 详细错误信息（可选）
  "code": string       // 错误代码（可选）
}