APIMaster.ai

MiniMax Voice Clone — 完整参数与计费

腾讯 TokenHub MiniMax Voice Clone 的原生接口、全部请求字段、响应、用量计费和官方参考价格。

MiniMax Voice Clone

使用 APIMaster API Key:Authorization: Bearer $APIMASTER_API_KEY,请求类型为 application/json。本页完整路径中的 /v1 已包含在 https://apimaster.ai/v1 中,例如 /v1/wand/... 对应 https://apimaster.ai/v1/wand/...。

网关先预留额度,收到上游实际用量后只结算一次,多余预留额度返还。余额不足时请求会在提交前拒绝。网络中断后请保留 request_id,避免盲目重发生成请求。

POST /v1/wand/minimax-tts/sync_clone,JSON、Bearer 鉴权。模型 minimax-voice-clone,生成可供后续 TTS 使用的 voice_id。只使用有权用于复刻的声音样本。

参数 类型 必填 说明
model string 是 minimax-voice-clone
audio_url string 条件 样本音频公网 URL;mp3/m4a/wav,建议 10 秒–5 分钟,最多 20MB;与 audio_data 至少提供一种
audio_data string 条件 Base64 样本音频
file_id integer 不支持 上游文件 ID 参数;APIMaster 不接受此字段,请使用 audio_url 或 audio_data
tts_model string 否 试听语音模型,例如 minimax-speech-2.8-hd;有试听文本时同时指定
voice_id string 否 不传自动生成;自定义时长度 8–256,英文字母开头,允许字母、数字、连字符、下划线;结尾不可为连字符/下划线
text string 否 最多 1000 字符的试听文本;提供时按 tts_model 合成试听
text_validation string 否 样本预期转写,最多 200 字符;ASR 匹配不足时拒绝
accuracy number 否 转写相似度阈值,0–1,默认 0.7
output_format string 否 hex(默认)/url,试听 URL 有效期 24 小时

响应字段:voice_id、input_sensitive、demo_audio、extra_info、base_resp、usage。demo_audio 只在提供 text 时返回;extra_info 也对应试听,含 audio_length(毫秒)、audio_sample_rate(Hz)、audio_size(字节)、bitrate、word_count、usage_characters。base_resp.status_code=0 为成功;status_msg 描述错误。usage.total_token 为计费 tokens,需兼容实测中可能出现的 total_tokens。

音色创建不立即收取音色费;首次正式使用该音色合成时收取 $1.50(937,500 个 TokenHub 计费 tokens),试听按所选 TTS 模型字符价另计。临时音色 7 天内未正式使用会被删除。声音创建、试听和首次 TTS 的费用归属须联合核对,避免重复扣音色费。核查日期 2026-11-11。

后续请求在语音合成的 voice_setting.voice_id 填入返回的完整引用;该音色只能由创建它的账户使用。

来源:腾讯官方接口文档

音色引用与账户隔离

可直接使用的系统音色为 English_Graceful_Lady、English_Trustworthy_Man、male-qn-qingse、male-qn-jingying、female-shaonv、female-yujie。自定义音色必须使用本账户通过音色设计或复刻接口返回的完整 thvoice_... 引用;该值可以直接放入 voice_setting.voice_id 或 timbre_weights[].voice_id。不能填写其他账户的引用或裸上游私有音色 ID。自定义创建时提供的 voice_id 会按账户命名空间转换,请以响应中的引用为准。

通过 audio_url 或 audio_data 提供样本。公开网关不接受 file_id,也不提供文件上传接口。

官方参考价格

下表是腾讯国际站官方目录价(2026-11-11),APIMaster 当前售价请打开对应模型卡。媒体统一按上游实际计费 tokens 结算,每百万计费 tokens $1.60,不能将此单价理解为每张或每秒费用。

模型 规格 用量换算 目录参考价
minimax-voice-clone - 每音色折合 937500 tokens 1.5 美元/音色

先注册,再在控制台创建密钥,按本页的具体模型 ID 调用 https://apimaster.ai/v1。