MiniMax Voice Design

使用 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_design，JSON、Bearer 鉴权。自然语言生成虚拟音色，不需要参考音频；不是语音复刻接口。

参数	类型	必填	说明
model	string	是	minimax-voice-design
prompt	string	是	音色描述，可描述年龄、性别、声线、情绪及应用场景
preview_text	string	是	试听文本，最多 500 字符，由平台默认 TTS 合成；不能误写成 text
voice_id	string	否	自定义音色 ID；省略由上游生成
output_format	string	否	hex（默认）/url；试听 URL 有效期 24 小时
aigc_watermark	boolean	否	音频末尾标识，默认 false

{"model":"minimax-voice-design","prompt":"温和清晰的成年虚拟讲解员，语速自然","preview_text":"欢迎收听今天的节目。","output_format":"url"}

响应含 voice_id、trial_audio、base_resp.status_code/status_msg、usage.total_token。trial_audio 为 hex 或 URL；状态码 0 才算成功，HTTP 200 本身不能作为依据。用 voice_id 在后续 TTS 的 voice_setting.voice_id 指定此音色。

官方目录音色费为 $1.50（937,500 个计费 tokens）；本次实测新设计音色首次合成收取 1,875,000 个附加计费 tokens，折合 $3.00，另加正文语音用量。重复使用仅计正文用量，详情见下方实测差异。创建时试听按字符另计；7 天内未正式使用的临时音色会被删除。核查日期 2026-11-11。

创建后可播放 trial_audio 试听，在后续 TTS 请求中使用返回的完整音色引用。失败时请保留 request_id 或 trace_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 会按账户命名空间转换，请以响应中的引用为准。

实测差异（2026-11-11）：一个新设计音色首次 TTS 返回 1,876,350 个 tokens，其中文本 36 字符 × 37.5 = 1,350，其余 1,875,000 个 tokens 折合 $3.00；重复使用只返回文本 1,350 个 tokens。目录参考音色费与该次上游用量存在差异，实际费用以返回的 billing tokens 和最终账单为准，网关不会把它硬改为目录 $1.50。

官方参考价格

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

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

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