語音合成

聲音克隆

對口型視頻

其他

語音合成 — 多人劇本 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 | wav，默認 mp3
可選項：mp3
cache
boolean
可選，false 返回音頻流；true 緩存並返回 audio_url
speed
number
可選，語速 0.5-2.0，默認 1
volume
number
可選，音量 -20~20，默認 0
stability
number
可選，0.5-1.5，默認 1
similarity
number
可選，0.5-1.5，默認 1
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       // 錯誤代碼（可選）
}