跳到正文

列出音色

列出系統音色、你的 MiniMax 複製音色或豆包複刻音色;免費。

POST/v1/get_voice

MiniMax 與豆包共用這個路徑,請在下方選擇系列查看請求主體與回應。

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。

請求標頭

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 物件

錯誤

400MiniMax:voice_type must be one of system, voice_cloning, voice_generation, all,或出現未知欄位。豆包:缺 model、未知欄位,或 unknown_voice(voice_id 不存在)
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)

相關頁面