音色快速复刻

POST /minimax/v1/voice_clone

MethodPOST
Path/minimax/v1/voice_clone
Typehttp
Status-2
Module2102810
Folder78007621

说明

https://platform.minimaxi.com/docs/api-reference/voice-cloning-clone 上传的音频文件格式需为:mp3、m4a、wav 格式 上传的音频文件的时长最少应不低于 10 秒,最长应不超过 5 分钟 上传的音频文件大小需不超过 20 mb 若使用该参数,则两个子属性(prompt_audio、prompt_text)都为必填项

概览

MethodPOST
Path/minimax/v1/voice_clone
Typehttp
Status-2
Module2102810
Folder78007621

请求体

{
  "type": "application/json",
  "parameters": [],
  "jsonSchema": {
    "type": "object",
    "properties": {
      "file_id": {
        "type": "integer",
        "description": "待复刻音频的 file_id,通过文件上传接口获得。音频要求:mp3/m4a/wav 格式,10秒-5分钟,<20MB"
      },
      "voice_id": {
        "type": "string",
        "description": "自定义音色 ID(长度 8-256,首字符必须为字母,允许数字/字母/-/,末位不可为 -/ )"
      },
      "clone_prompt": {
        "type": "object",
        "properties": {
          "prompt_audio": {
            "type": "integer"
          },
          "prompt_text": {
            "type": "string"
          }
        },
        "required": [
          "prompt_audio",
          "prompt_text"
        ],
        "x-apifox-orders": [
          "prompt_audio",
          "prompt_text"
        ],
        "description": "示例音频对象,增强相似度和稳定性"
      },
      "text": {
        "type": "string",
        "description": "复刻试听文本(限制 1000 字符,支持语气词标签)"
      },
      "model": {
        "type": "string",
        "description": "试听音频使用的语音模型 speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo"
      },
      "language_boost": {
        "type": "string",
        "description": "增强对指定语言/方言的识别能力。可设置为 auto 自动判断,或指定具体语言"
      },
      "need_noise_reduction": {
        "type": "boolean",
        "description": "是否开启降噪"
      },
      "need_volume_normalization": {
        "type": "boolean",
        "description": "是否开启音量归一化"
      },
      "aigc_watermark": {
        "type": "boolean",
        "description": "是否在试听音频末尾添加音频节奏标识"
      }
    },
    "required": [
      "file_id",
      "voice_id"
    ],
    "x-apifox-orders": [
      "file_id",
      "voice_id",
      "clone_prompt",
      "text",
      "model",
      "language_boost",
      "need_noise_reduction",
      "need_volume_normalization",
      "aigc_watermark"
    ]
  },
  "required": true,
  "mediaType": "",
  "examples": [
    {
      "mediaType": "application/json",
      "value": "{\r\n  \"file_id\": 365182159339614,\r\n  \"voice_id\": \"MyCustomVoice003\",\r\n  \"clone_prompt\": {\r\n    \"prompt_audio\": 987654321,\r\n    \"prompt_text\": \"This voice sounds natural and pleasant.\"\r\n  },\r\n  \"text\": \"A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.\",\r\n  \"model\": \"speech-2.8-hd\",\r\n  \"language_boost\": \"English\",\r\n  \"need_noise_reduction\": true,\r\n  \"need_volume_normalization\": true,\r\n  \"aigc_watermark\": false\r\n}",
      "name": "示例 1"
    }
  ],
  "oasExtensions": ""
}

响应

[
  {
    "id": 175461063,
    "name": "成功",
    "code": 200,
    "contentType": "json",
    "jsonSchema": {
      "type": "object",
      "properties": {}
    },
    "itemSchema": {},
    "description": "",
    "mediaType": "",
    "headers": []
  }
]