跳到正文

列出音色

列出系统音色、你的 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)

相关页面