列出聲音

GET /api/open/v1/voices

完整網址：

https://kittaai.com/api/open/v1/voices

標題

Authorization: Bearer FISHAUDIO_API_KEY

列出聲音是唯讀的。它不會創建任務或消耗積分。

查詢選項

端點從 URL 查詢參數中讀取可選過濾器。如果省略，API 會傳回公共語音的第一頁。

領域	類型	必填	說明
`page`	整數	沒有	頁碼。預設值：`1`
`pageSize`	整數	沒有	每頁的項目。預設值：`20`，最大：`100`
`modelType`	字串	沒有	`public`、`personal` 或 `all`
`includePersonal`	布林	沒有	當 `true` 時，預設模型類型變成 `all`

回覆

{
  "total": 1,
  "page": 1,
  "pageSize": 20,
  "totalPages": 1,
  "items": [
    {
      "voiceId": "voice_123",
      "title": "Clara",
      "description": "",
      "created_at": "2026-07-09T00:00:00.000Z",
      "updated_at": "2026-07-09T00:00:00.000Z",
      "isPersonal": false
    }
  ]
}

在 TTS 請求中使用 items[].voiceId。

快速測試語音

要在從回應中選擇語音之前測試 TTS，請使用此公共系統語音 ID：

00a1b221-6137-4b73-ad62-b0cbce134167

當您準備好選擇製作語音時，請將其替換為 items[].voiceId 值。

curl 範例

curl "https://kittaai.com/api/open/v1/voices?page=1&pageSize=20&modelType=public" \
  -H "Authorization: Bearer FISHAUDIO_API_KEY"

錯誤

狀態	意義
`401`	API 金鑰遺失或無效
`403`	帳號無法列出聲音
`500`	語音目錄查詢失敗

列出聲音

列出聲音

標題

查詢選項

回覆

快速測試語音

curl 範例

錯誤

本頁內容