語音克隆

POST /api/open/v1/voices
Authorization: Bearer FISHAUDIO_API_KEY
Content-Type: multipart/form-data

完整網址：

https://fishaudio.org/api/open/v1/voices

語音建立使用參考音訊和 FishAudio 建立流程。 Open API 路由會忽略提供者覆蓋，因此您不需要傳送 provider 欄位。

請求字段

領域	類型	必填	說明
`name`	字串	是的	聲音名稱
`audioFiles`	檔[]	是的	一個或多個參考音檔
`description`	字串	沒有	語音描述
`referenceText`	字串	沒有	參考音訊的文字記錄
`visibility`	字串	沒有	`private` 或 `public`。預設：`private`
`languages`	字串	沒有	JSON 字串數組，如 `'["zh","en"]'`

支援的檔案副檔名：aac、flac、m4a、mp3、mp4、mpeg、oga、ogg、mpeg、oga、ogg、opusX、QPHQZX每個檔案最大可達10MB。

請勿手動設定多部分邊界。使用curl -F、瀏覽器FormData或SDK時，讓客戶端產生Content-Type。

curl 範例

curl -X POST "https://fishaudio.org/api/open/v1/voices" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY" \
  -F "name=My cloned voice" \
  -F "description=Chinese narration voice" \
  -F "visibility=private" \
  -F 'languages=["zh"]' \
  -F "audioFiles=@/path/to/sample-1.mp3;type=audio/mpeg" \
  -F "audioFiles=@/path/to/sample-2.wav;type=audio/wav"

回覆

{
  "voiceId": "voice_abc123",
  "title": "My cloned voice",
  "description": "Chinese narration voice",
  "createdAt": "2026-07-09T00:00:00.000Z"
}

儲存傳回的voiceId，然後產生語音時直接傳遞。

錯誤

狀態	意義
`400`	缺少欄位、不支援的檔案類型或檔案過大
`401`	API 金鑰遺失或無效
`403`	帳號無法建立聲音
`429`	語音建立請求過於頻繁
`500`	伺服器上建立語音失敗

建立語音記錄 Open API 使用情況，並受目前帳戶的 Open API 配額和供應商分配的影響。

語音克隆

語音克隆

請求字段

curl 範例

回覆

錯誤

本頁內容