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 美元/音色 |
