音频生成
Authorizationstring*将{token}替换为提供给您的token
Token {your api key}textstring*需要合成语音的文本normal长度限制小于 10000 字符numbernormal段落切换用换行符标记numbernormal停顿控制：支持自定义文本之间的语音时间间隔，以实现自定义文本语音停顿时间的效果。numbernormal使用方式：在文本中增加<#x#>标记，x 为停顿时长（单位：秒），范围 \[0.01, 99.99\]，最多保留两位小数。文本间隔时间需设置在两个可以语音发音的文本之间，不可连续使用多个停顿标记bulletnormal
你好<#2#>我是vidu<#2#>很高兴见到你bulletnormalvoice_setting_voice_idstring*Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*路径参数，任务的唯一标识（ID）。
{your_id}idstring*任务id，由创建任务接口创建成功返回
合成音频的音色id
可查看音色列表查询全部可用音色
your_voice_setting_voice_idvoice_setting_speednumber语速，默认为1.0
1.0为正常语速，范围 \[0.5,2\]，值为0.5时播报语速最慢，值为2时播报语速最快
voice_setting_volumeinteger音量大小
范围 0 - 10，默认为0，代表正常音量，值越大音量越高
voice_setting_pitchinteger合成音频的语调
范围 \[-12,12\]，默认 0，其中 0 为原音色输出
voice_setting_emotionstring控制合成语音的情绪
pronunciation_dict_tonearray定义多音字发音
payloadstring透传参数
不做任何处理，仅数据传输
注：最多 1048576个字符
application/json返回参数
idstring任务ID
statestring处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadapplication/json返回参数
task_idstringVidu生成的任务ID
statestring处理状态
可选值：queueing 任务排队中success 任务成功failed 任务失败
file_urlstring音频文件url
creditsinteger本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 24小时有效期
cover_urlstring生成物封面，24小时有效期
watermarked_urlstring本次调用使用的积分数
payloadstring本次调用时传入的透传参数
created_atstring任务创建时间
带水印的生成物url，24小时有效期
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/audio-tts' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"text": "你好<#2#>我是vidu<#2#>很高兴见到你bulletnormal",
"voice_setting_voice_id": "your_voice_setting_voice_id",
"voice_setting_speed": 0,
"voice_setting_volume": 0,
"voice_setting_pitch": 0,
"voice_setting_emotion": "string",
"pronunciation_dict_tone": [],
"payload": "string"
}'{
"task_id": "your_task_id_here",
"state": "success",
"file_url": "your_file_url_here",
"credits": ,
"payload":"",
"created_at": "2025-01-01T15:41:31.968916Z"
}curl --request GET \
--url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json'{
"id":"your_task_id",
"state": "success",
"err_code": "",
"credits": 4,
"payload": "",
"creations": [
{
"id": "your_creations_id",
"url": "your_generated_results_url",
"cover_url": "your_generated_results_cover_url",
"watermarked_url": "your_generated_results_watermarked_url"
}
]
}