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