创建任务
POST
/ent/v2/timing2audio可控文生音效,支持通过输入提示词,生成一段可控时序的音效(不支持输出背景音乐 BGM)。用户可以基于时间轴,灵活控制多个事件音效的触发时长。
查询生成物
GET
/ent/v2/tasks/{id}/creations音频生成
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}modelstring*模型名称可选值:audio1.0
durationnumber音频时长默认 10,可选范围:2~10 秒内
timing_promptsstring*可控音效参数。描述多个音效事件及各自时间区间,支持多个事件重叠。- 单个事件最大提示词字符数:1500 字符- from、to 必须在 \[0, duration\] 区间内
seedinteger随机种子随机种子,若不传或传0则自动生成随机数,传固定值生成确定性结果
callback_urlstringCallback 协议需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态:- processing 任务处理中- success 任务完成(如发送失败,回调三次)- failed 任务失败(如发送失败,回调三次)Vidu采用回调签名算法进行认证,详情见:回调签名算法
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/timing2audio' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"model": "string",
"duration": 0,
"timing_prompts": "string",
"seed": 0,
"callback_url": "string"
}'{
"task_id": "your_task_id_here",
"state": "created",
"model": "audio1.0",
"duration": 10,
"timing_prompts": [
{
"from": 0.0,
"to": 3.0,
"prompt": "清晨的鸟叫声"
},
{
"from": 3.0,
"to": 6.0,
"prompt": "远处传来火车驶过的声音"
},
{
"from": 5.0,
"to": 9.5,
"prompt": "海浪轻轻拍打沙滩"
}
],
"seed": random_number,
"credits":credits_number,
"created_at": "2025-01-01T10:00:00.000Z"
}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处理状态 可选值:
-created 创建成功
-queueing 任务排队中
-processing 任务处理中
-success 任务成功
-failed 任务失败
modelstring本次调用的模型名称
application/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小时有效期
durationinteger本次调用的视频时长参数
timing_promptsarray本次调用中定义的多个音频事件参数
seedinteger本次调用的随机种子参数
creditsinteger本次调用使用的积分数
created_atstring任务创建时间