1. MINIMAX
梧柏API使用文档
WHBAI · MiniMax
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • MiniMax
    • 上传示例音频
      POST
    • 提交视频生成任务
      POST
    • 查询视频生成任务
      GET
    • 异步语音合成
      POST
    • 查询异步语音合成任务
      GET
    • 文本合成
      POST
    • 检索(用于视频下载,异步音频下载)
      GET
    • 音色设计
      POST
  • 品牌平台
    • MINIMAX
      • 音色快速复刻
        POST
  • 语音合成
    • 同步语音合成 V2
      POST
  • 数据模型
    • MinimaxBaseResp
    • MinimaxVideoSubmitResponse
    • MinimaxVideoQueryResponse
    • MinimaxT2ASubmitResponse
    • MinimaxT2AQueryResponse
    • PostMinimaxV1VideoGenerationRequest
    • PostMinimaxV1T2aAsyncV2Request
    • PostMinimaxV1VoiceCloneRequest
    • MinimaxSampleResponse
    • PostMinimaxV1VideoGenerationResponse
    • GetMinimaxV1QueryT2aAsyncQueryV2Response
    • PostV1MessagesRequest
    • PostV1MessagesResponse
    • T2aV2StreamResponse
    • GetMinimaxV1FilesRetrieveResponse
    • NewApiError
  1. MINIMAX

音色快速复刻

开发中
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)都为必填项

网站中的模型与调用示例#

音色快速复刻#

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

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "accuracy": {
      "description": "ASR 相似度阈值,默认 0.7,范围 [0, 1]。",
      "type": "number",
      "x-i18n": {
        "en-US": {
          "description": "ASR similarity threshold, default 0.7, range [0, 1]."
        }
      }
    },
    "aigc_watermark": {
      "description": "是否在试听音频末尾添加音频节奏标识",
      "type": "boolean",
      "x-i18n": {
        "en-US": {
          "description": "Whether to add an audio rhythm identifier at the end of the preview audio"
        }
      }
    },
    "audio_data": {
      "description": "待复刻音频的 base64 音频。(audio_url 或 audio_data 至少传一个)",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "The base64 audio of the audio to be cloned. (At least one of audio_url or audio_data must be provided)"
        }
      }
    },
    "audio_url": {
      "description": "待复刻音频的 URL 地址(http/https 链接)。音频规范:mp3 / m4a / wav,建议时长 10 秒–5 分钟,大小 ≤ 20MB。",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "The URL address of the audio to be cloned (http/https link). Audio specifications: mp3/m4a/wav, recommended duration 10 seconds to 5 minutes, size ≤ 20MB."
        }
      }
    },
    "clone_prompt": {
      "description": "示例音频对象,增强相似度和稳定性 上传示例音频所得",
      "type": "object",
      "x-i18n": {
        "en-US": {
          "description": "Example audio object to enhance similarity and stability, obtained from the uploaded example audio"
        }
      }
    },
    "file_id": {
      "description": "待复刻音频的 file_id,通过文件上传接口获得。音频要求:mp3/m4a/wav 格式,10秒-5分钟,<20MB",
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "The file_id of the audio to be cloned, obtained through the file upload interface. Audio requirements: mp3/m4a/wav format, 10 seconds to 5 minutes, <20MB"
        }
      }
    },
    "language_boost": {
      "description": "增强对指定语言/方言的识别能力。可设置为 auto 自动判断,或指定具体语言",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Enhance recognition capabilities for a specific language/dialect. Can be set to auto for automatic detection or specify a specific language"
        }
      }
    },
    "model": {
      "description": "试听音频使用的语音模型 speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Voice model used for the preview audio: speech-2.6-hd, speech-2.6-turbo, speech-02-hd, speech-02-turbo"
        }
      }
    },
    "need_noise_reduction": {
      "description": "是否开启降噪",
      "type": "boolean",
      "x-i18n": {
        "en-US": {
          "description": "Whether to enable noise reduction"
        }
      }
    },
    "need_volume_normalization": {
      "description": "是否开启音量归一化",
      "type": "boolean",
      "x-i18n": {
        "en-US": {
          "description": "Whether to enable volume normalization"
        }
      }
    },
    "output_format": {
      "description": "试听音频返回形式,默认 hex,可选 url / hex(url 有效期 24h)。",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "The return format of the preview audio, default hex, options are url / hex (url valid for 24h)."
        }
      }
    },
    "text": {
      "description": "复刻试听文本(限制 1000 字符,支持语气词标签)",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Cloning preview text (limited to 1000 characters, supports filler word tags)"
        }
      }
    },
    "text_validation": {
      "description": "音频复刻样本的预期文本,≤ 200 字符;服务做 ASR 识别并比对相似度,低于 accuracy 则拒绝。",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "The expected text of the audio cloning sample, ≤ 200 characters; the service performs ASR recognition and compares similarity, and will reject if below accuracy."
        }
      }
    },
    "voice_id": {
      "description": "自定义音色 ID(长度 8-256,首字符必须为字母,允许数字/字母/-/,末位不可为 -/ )",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "Custom voice ID (length 8-256, must start with a letter, allows numbers/letters/-/, cannot end with -/)"
        }
      }
    }
  },
  "required": [
    "file_id",
    "voice_id"
  ]
}

tags#

[
  "品牌平台/MINIMAX"
]

请求参数

Body 参数application/json必填

示例
{
    "file_id": 365182159339614,
    "voice_id": "MyCustomVoice003",
    "clone_prompt": {
        "prompt_audio": 987654321,
        "prompt_text": "This voice sounds natural and pleasant."
    },
    "text": "A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.",
    "model": "speech-2.8-hd",
    "language_boost": "English",
    "need_noise_reduction": true,
    "need_volume_normalization": true,
    "aigc_watermark": false
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/minimax/v1/voice_clone' \
--header 'Content-Type: application/json' \
--data '{
    "file_id": 365182159339614,
    "voice_id": "MyCustomVoice003",
    "clone_prompt": {
        "prompt_audio": 987654321,
        "prompt_text": "This voice sounds natural and pleasant."
    },
    "text": "A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.",
    "model": "speech-2.8-hd",
    "language_boost": "English",
    "need_noise_reduction": true,
    "need_volume_normalization": true,
    "aigc_watermark": false
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "voice_id": "MiniMax001-xxxxxxxx",
    "input_sensitive": false,
    "demo_audio": "https://...试听音频链接",
    "extra_info": {
        "audio_length": 11124,
        "audio_sample_rate": 32000,
        "audio_size": 179926,
        "bitrate": 128000,
        "word_count": 18,
        "usage_characters": 18
    },
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    },
    "usage": {
        "total_token": 1920
    }
}
修改于 2026-10-24 18:33:12
上一页
音色设计
下一页
同步语音合成 V2
Built with