同步语音合成 V2
POST
/minimax/v1/t2a_v2
网站中的模型与调用示例
同步语音合成 V2
请求示例 · 最简单的语音合成示例
{
"model": "speech-02-hd",
"text": "你好，欢迎使用语音合成服务！",
"voice_setting": {
"voice_id": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85"
}
}请求示例 · 使用语气词标签增强表现力
{
"audio_setting": {
"bitrate": 128000,
"channel": 1,
"format": "mp3",
"sample_rate": 32000
},
"model": "speech-2.8-hd",
"pronunciation_dict": {
"tone": [
"处理/(chu3)(li3)",
"危险/dangerous"
]
},
"stream": false,
"subtitle_enable": false,
"text": "今天是不是很开心呀(laughs)，当然了(breath)！",
"voice_setting": {
"emotion": "happy",
"pitch": 0,
"speed": 1,
"voice_id": "male-qn-qingse",
"vol": 1
}
}请求示例 · 流式输出可以更快地获得音频反馈
{
"audio_setting": {
"force_cbr": true,
"format": "mp3"
},
"model": "speech-2.8-turbo",
"stream": true,
"stream_options": {
"exclude_aggregated_audio": false
},
"text": "这是一段较长的文本，使用流式输出可以边合成边播放，减少等待时间。",
"voice_setting": {
"speed": 1.2,
"voice_id": "English_Graceful_Lady"
}
}请求示例 · 使用多种音色混合创造独特声音
{
"model": "speech-2.6-hd",
"text": "这是使用混合音色的语音合成示例。",
"timber_weights": [
{
"voice_id": "female-chengshu",
"weight": 30
},
{
"voice_id": "female-tianmei",
"weight": 70
}
],
"voice_setting": {
"speed": 1,
"voice_id": "",
"vol": 1
}
}请求示例 · 使用声音效果器调整音色特征
{
"model": "speech-2.6-hd",
"text": "这是带声音效果器的语音合成。",
"voice_modify": {
"intensity": -30,
"pitch": 20,
"sound_effects": "robotic",
"timbre": 10
},
"voice_setting": {
"voice_id": "English_Persuasive_Man"
}
}响应示例 · 非流式合成完成后的完整响应
{
"base_resp": {
"status_code": 0,
"status_msg": "success"
},
"data": {
"audio": "2f2f2f2f504b0304...",
"status": 2
},
"extra_info": {
"audio_channel": 1,
"audio_format": "mp3",
"audio_length": 9900,
"audio_sample_rate": 32000,
"audio_size": 160323,
"bitrate": 128000,
"invisible_character_ratio": 0,
"usage_characters": 26,
"word_count": 52
},
"trace_id": "01b8bf9bb7433cc75c18eee6cfa8fe21"
}响应示例 · 启用字幕功能后的响应
{
"base_resp": {
"status_code": 0,
"status_msg": "success"
},
"data": {
"audio": "2f2f2f2f504b0304...",
"status": 2,
"subtitle_file": "https://filecdn.minimax.chat/subtitle/subtitle_123.json"
},
"extra_info": {
"audio_length": 12000,
"audio_sample_rate": 32000,
"audio_size": 195000,
"usage_characters": 68,
"word_count": 68
},
"trace_id": "subtitle_example_123"
}响应示例 · 参数错误
{
"base_resp": {
"status_code": 2013,
"status_msg": "输入参数信息不正常：voice_id 不能为空"
}
}响应示例 · 鉴权失败
{
"base_resp": {
"status_code": 1004,
"status_msg": "鉴权失败，请检查 API-Key 是否正确"
}
}响应示例 · 触发限流
{
"base_resp": {
"status_code": 1002,
"status_msg": "触发限流，请稍后再试"
}
}请求参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-10-24 18:33:12