该接口可以根据文本合成朗读音频。

请求信息

请求 URL

POST /hub/vidu/v2/audio-tts

请求头

Header	必填	示例值
Authorization	是	Bearer sk-xxxxx
Content-Type	是	application/json; charset=utf-8

请求体

字段	类型	必填	说明
text	string	是	待合成文本，最长 10000 字符。支持换行分段，支持使用 <#x#> 控制停顿时长
voice_setting_voice_id	string	是	音色 ID
voice_setting_speed	float	否	语速，默认 1.0。常见范围：0.5-2
voice_setting_volume	int	否	音量。常见范围：0-10，默认 0
voice_setting_pitch	int	否	音调。常见范围：-12 到 12，默认 0
voice_setting_emotion	string	否	情绪参数。常见值：happy、sad、angry、fearful、disgusted、surprised、calm
pronunciation_dict_tone	string[]	否	多音字或发音替换规则
payload	string	否	透传字段，最长 1048576 字符

请求示例

json{
  "text": "你好<#1.5#>欢迎使用 AIHub 开放平台",
  "voice_setting_voice_id": "voice_cn_female",
  "voice_setting_speed": 1.0,
  "voice_setting_volume": 0,
  "voice_setting_pitch": 0,
  "voice_setting_emotion": "calm",
  "pronunciation_dict_tone": [
    "重阳/(chong2)(yang2)"
  ]
}

响应信息

响应体

字段	类型	说明
task_id	string	任务 ID
state	string	任务状态。常见值：queueing、success、failed
file_url	string	生成音频地址
credits	string	消耗量
payload	string	透传字段
created_at	string	创建时间

响应示例

json{
  "task_id": "tsk_1234567903",
  "state": "success",
  "file_url": "https://example.com/output.mp3",
  "credits": "1.500000",
  "payload": "",
  "created_at": "2026-04-16T09:43:00Z"
}

错误码

完整列表请参考客户端 API 错误码。