创建任务
POST
/ent/v2/audio-clone该接口可用于复刻真人音色,并使用该音色朗读指定文本。
该接口是同步接口,不需要回调。
查询生成物
GET
/ent/v2/tasks/{id}/creations音频生成
产出的快速复刻音色为临时音色,若希望永久保留某复刻音色,请于 168 小时(7 天)内在语音合成接口中调用该音色(不包含本接口内的试听行为),若超过时限,该音色将被删除,复刻所消耗的积分不会退还。
Authorizationstring*将{token}替换为提供给您的token
Token {your api key}audio_urlstring*原音频 URL(需要确保可访问)
模型将以此参数中传入的音频音色为示例对音色进行复刻
注1:视频仅支持格式:mp3、m4a、wav;
注2:上传的音频文件的时长最少应不低于 10 秒,最长应不超过 5 分钟;
注3:上传的音频文件大小需不超过20mb;
注4:音频内容免涉版权,否则会被下架或销毁
your_audio_urlvoice_idstring*自定义的声音ID,,用户进行自定义 voice_id 时需注意:normal自定义的 voice_id 长度范围\[8,256\]bulletnormal首字符必须为英文字母bulletnormal允许数字、字母、横线、下划线bulletnormal末位字符不可为 -、\_\*bulletnormalvoice_id 不可与已有 id 重复,否则会报错bulletnormal
vidu01prompt_audio_urlstring音色复刻示例音频
提供本参数将有助于增强语音合成的音色相似度和稳定性,若使用本参数,需同时上传一小段示例音频。
注1:视频仅支持格式:mp3、m4a、wav;
注2:上传的音频文件的时长最少应小于 8 秒;
注3:上传的音频文件大小需不超过20mb
prompt_textstring示例音频对应的文本内容
需确保和音频内容一致,句末需有标点符号做结尾
textstring*复刻试听参数
限制 1000 字符以内,模型将使用复刻后的音色朗读本段文本内容,并返回试听音频链接。
注:试听将根据字符数正常收取语音合成费用
你好,欢迎使用vidu开放平台payloadstring透传参数
不做任何处理,仅数据传输
注:最多 1048576个字符
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*路径参数,任务的唯一标识(ID)。
{your_id}idstring*任务id,由创建任务接口创建成功返回
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/audio-clone' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"audio_url": "your_audio_url",
"voice_id": "vidu01",
"prompt_audio_url": "string",
"prompt_text": "string",
"text": "你好,欢迎使用vidu开放平台",
"payload": "string"
}'{
"task_id": "your_task_id_here",
"state": "success",
"voice_id": "your_voice_id_here",
"demo_audio": "your_demo_audio_here",
"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"
}
]
}application/json返回参数
task_idstringVidu生成的任务ID
statestring处理状态
可选值:
queueing 任务排队中success 任务成功failed 任务失败voice_idapplication/json返回参数
idstring任务ID
statestring处理状态
可选值:
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码,具体见错误码表
creditsinteger该任务消耗的积分数量,单位:积分
payloadstring本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id,用来标识不同的生成物
urlstring生成物URL, 24小时有效期
cover_urlstring生成物封面,24小时有效期
watermarked_urlstring带水印的生成物url,24小时有效期
用户自定义的 voice_id,如果任务失败则不返回
demo_audiostring如果请求体中传入了试听文本 text,那么本参数将以链接形式返回试听音频,否则本参数为空值
payloadstring本次调用时传入的透传参数
created_atstring任务创建时间