列出音色

POST/v1/get_voice

voice_type 取 voice_cloning 列出你的複製音色，system 列出系統音色，all 為全部；voice_generation 始終為空。未請求的類別在回應裡為 null。

複製音色只列出你帳戶下已複製成功、尚未刪除或過期的音色。系統音色也可以直接看系統音色。

列出音色

curl https://api.hop-base.com/v1/get_voice \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "voice_cloning"
  }'

200application/json

{
  "system_voice": null,
  "voice_cloning": [
    {
      "voice_id": "MyNarrator01",
      "description": [],
      "created_time": "2026-09-25"
    }
  ],
  "voice_generation": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

請求標頭

Authorization:必填string

Bearer sk-…：主控台「API 金鑰」中建立的金鑰，所屬分組須包含請求的模型

請求主體參數JSON

voice_type:必填string

要列出的音色類別

可選值systemvoice_cloningvoice_generationall

回傳

200音色列表

system_voice:選填array of object 或 null

系統音色；未請求時為 null

voice_cloning:選填array of object 或 null

你的複製音色；未請求時為 null

voice_generation:選填array of object 或 null

始終為空陣列；未請求時為 null

base_resp:選填object

成功時為 {"status_code": 0, "status_msg": "success"}；錯誤不走這裡，而是非 200 狀態碼加 error 物件

錯誤

400voice_type must be one of system, voice_cloning, voice_generation, all，或出現未知欄位

401沒帶金鑰、金鑰無效或已過期（missing_api_key / invalid_api_key / api_key_expired）

413請求體超過 64 KiB：request body is too large

503音色或檔案登記暫不可用，稍後重試（如 voice registry is temporarily unavailable; please retry）

請求標頭

請求主體參數JSON

回傳

錯誤

相關頁面