列出音色
列出系統音色、你的 MiniMax 複製音色或豆包複刻音色;免費。
/v1/get_voiceMiniMax 與豆包共用這個路徑,請在下方選擇系列查看請求主體與回應。
MiniMax Speech 2.8:voice_type 取 voice_cloning 列出你的複製音色,system 列出系統音色,all 為全部;voice_generation 始終為空。未請求的類別在回應裡為 null。複製音色只列出你帳戶下已複製成功、尚未刪除或過期的音色。系統音色也可以直接看系統音色。
豆包聲音複刻 2.0:請求主體必須帶 "model": "seed-icl-2.0"。不傳 voice_id 時回傳 voices 陣列,列出你的全部複刻音色;傳了只回傳該音色物件,不存在或不屬於你的帳戶回傳 400 unknown_voice。
請求標頭
Bearer sk-…:主控台「API 密鑰」中建立的密鑰,所屬分組須包含請求的模型
請求主體參數JSON
要列出的音色類別
可選值systemvoice_cloningvoice_generationall
固定為 seed-icl-2.0,必填;HopBase 依它把請求交給豆包聲音複刻
可選值seed-icl-2.0
只查這一個複刻音色;不傳則列出全部
回傳
200音色列表
系統音色;未請求時為 null
你的複製音色;未請求時為 null
你起的音色名
恆為空陣列
建立日期,YYYY-MM-DD(UTC)
始終為空陣列;未請求時為 null
成功時為 {"status_code": 0, "status_msg": "success"};錯誤不走這裡,而是非 200 狀態碼加 error 物件
成功為 0
成功為 success
不傳 voice_id 時回傳:你的全部複刻音色;傳了 voice_id 時回應直接是該音色物件(欄位同陣列元素)
複刻音色 ID(hbv_ 開頭),合成時填到 /v1/audio/speech 的 voice
ready 可以合成;training 還在訓練,稍後再查;failed 訓練失敗,可帶上 voice_id 重新訓練或刪除
可選值readytrainingfailed
錄音語言程式碼
這個音色還能訓練的次數(每個音色共 15 次);用完後只能刪除再複刻
建立時間,Unix 秒
錯誤
voice_type must be one of system, voice_cloning, voice_generation, all,或出現未知欄位。豆包:缺 model、未知欄位,或 unknown_voice(voice_id 不存在)missing_api_key / invalid_api_key / api_key_expired)request body is too largevoice registry is temporarily unavailable; please retry)