POST
/minimax/v1/voice_clone音色快速复刻
https://platform.minimaxi.com/docs/api-reference/voice-cloning-clone 上传的音频文件格式需为：mp3、m4a、wav 格式 上传的音频文件的时长最少应不低于 10 秒，最长应不超过 5 分钟 上传的音频文件大小需不超过 20 mb 若使用该参数，则两个子属性（prompt_audio、prompt_text）都为必填项
API Key application/json
MiniMax 音色快速复刻
调用与返回说明
用已上传音频的 file_id 创建自定义 voice_id，可选生成试听音频。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- file_id 必须来自上传接口；音频需为 mp3/m4a/wav，10 秒至 5 分钟且小于 20 MB。
- voice_id 长度 8–256，首字符为字母，末尾不能是 - 或 _；text 与 model 同时提供时会产生试听费用。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- 保存返回的 voice_id；试听链接或音频字段为空并不表示复刻失败，需检查 base_resp。
Request
请求
/minimax/v1/voice_cloneBody
必填Bodyobjectfile_idinteger必填待复刻音频 file_id。
示例
123456789voice_idstring必填自定义音色 ID。
示例
QingyunVoice01clone_promptobject
clone_promptobjectprompt_audiointeger示例音频 file_id。
prompt_textstring示例音频文本。
textstring试听文本，不超过 1000 字符。
modelstring试听使用的 speech 型号。
示例
speech-2.8-hdlanguage_booststring语言增强。
need_noise_reductionboolean是否降噪。
need_volume_normalizationboolean是否音量归一化。
aigc_watermarkboolean是否添加音频节奏标识。
Response返回响应
成功响应返回响应 200
响应 200objectdemo_audiostring|null试听音频链接；只有传入 text 与 model 时返回。
extra_infoobject
extra_infoobjectaudio_lengthinteger试听音频时长。
usage_charactersinteger试听计费字符数。
base_respobject
base_respobjectstatus_codeinteger业务状态码。
status_msgstring状态描述。
MiniMax 音色快速复刻
调用与返回说明
用已上传音频的 file_id 创建自定义 voice_id，可选生成试听音频。
请求时注意
- 请求头使用 `Authorization: Bearer YOUR_API_KEY`；客户端只提交青云TOP API Key，不提交 MiniMax 上游密钥。
- 本文路径是青云TOP 的公开入口。它与 MiniMax 官方路径可能不同；以页面显示的完整本站 URL 为准，不要把官方域名或 `/v2` 自动拼到本站路径。
- 官方模型存在不等于当前 API Key 已开放。调用前请求 `GET /v1/models`，再结合分组权限、当前 pricing 和实际错误响应确认型号；生产 pricing 快照未覆盖全部官方 speech/H3 型号。
- file_id 必须来自上传接口；音频需为 mp3/m4a/wav，10 秒至 5 分钟且小于 20 MB。
- voice_id 长度 8–256，首字符为字母，末尾不能是 - 或 _；text 与 model 同时提供时会产生试听费用。
返回时注意
- HTTP 2xx 只表示请求被网关接受；还要检查响应体中的 `base_resp.status_code`、任务 `status` 或 Responses/兼容协议的业务字段。
- 官方临时音频、视频和文件 URL 有效期有限。成功后立即下载或转存到自己的对象存储，不要把示例地址当作永久资源。
- 余额、分组权限、内容安全、限流和模型下线都可能导致业务失败；记录 trace/request ID 和完整错误信息，按退避策略重试。
- 保存返回的 voice_id；试听链接或音频字段为空并不表示复刻失败，需检查 base_resp。