Skip to main content
概述
  • 路径：POST /minimaxi/v1/voice_clone
  • 媒介类型：application/json
  • 适用场景：IP 复刻、音色克隆等需要快速复刻某一音色的场景。

​
快速开始：三步完成音色复刻

  1. 上传待复刻音频，获取 file_id
curl -X POST "$BASE_URL/minimaxi/v1/files/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "purpose=voice_clone" \
  -F "file=@/path/to/audio.mp3"
响应体中的：
  • file.file_id：后续传给 POST /minimaxi/v1/voice_clone
  • file.filename：原始文件名
  1. （可选）上传示例音频，获取 prompt_audio 的 file_id
curl -X POST "$BASE_URL/minimaxi/v1/files/upload" \
  -H "Authorization: Bearer $TOKEN" \
  -F "purpose=prompt_audio" \
  -F "file=@/path/to/short-sample.mp3"
  1. 调用音色快速复刻接口，完成音色克隆并获取试听音频
请求字段（对齐 MiniMax 官方 /v1/voice_clone）
  • file_id：必填，需要复刻音色的音频文件 file_id，通过 POST /minimaxi/v1/files/upload 获取
  • voice_id：必填，目标克隆音色的 voice_id，需满足官方命名规范
  • clone_prompt：可选，示例音频与文本，用于增强相似度和稳定性
    • prompt_audio：示例音频的 file_id（通过 purpose=prompt_audio 上传获得）
    • prompt_text：示例音频对应文本
  • text：可选，复刻试听文本（官方限制 ≤ 1000 字符）
  • model：当传入 text 时必填，试听所用语音模型（如 speech-2.6-hd、speech-2.6-turbo 等）
  • language_boost：可选，小语种/方言增强，支持 Chinese、English、...、auto 等枚举
  • need_noise_reduction：可选，是否开启降噪
  • need_volume_normalization：可选，是否开启音量归一化
  • aigc_watermark：可选，是否在试听音频末尾添加 AIGC 水印节奏
返回字段
  • input_sensitive：可选，输入音频命中风控时返回，包含 type 等信息
  • demo_audio：若传入 text 与 model，则返回试听音频链接
  • base_resp：基础返回信息
    • status_code：状态码（0 为成功）
    • status_msg：状态描述
示例：带试听音频返回 
curl -X POST "$BASE_URL/minimaxi/v1/voice_clone" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": 1234567890,
    "voice_id": "MiniMax001",
    "text": "近年来，人工智能在国内迎来高速发展期...",
    "model": "speech-2.6-hd",
    "need_noise_reduction": true,
    "need_volume_normalization": true
  }'