创建任务
POST
/ent/v2/template-story查询生成物
GET
/ent/v2/tasks/{id}/creations一键解决方案
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}storystring*模板成片参数
可选值:love_story、workday_feels、monkey_king、pigsy、monk_tang、one_shot
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*路径参数,任务的唯一标识(ID)。
{your_id}idstring*任务id,由创建任务接口创建成功返回
choose_one_accept_valueimagesstring*图像
模型将以此参数中传入的图片来生成视频。
注1:支持传入图片 Base64 编码或图片URL(确保可访问);
注2:图片支持 png、jpeg、jpg、webp格式;
注3:图片比例要求,请查阅场景示例中心-模板成片-;
注4:one_shot视频比例与输入首图的比例相同;
注5:图片大小不超过 50 MB;
注6:请注意,http请求的post body不超过20MB,且编码必须包含适当的内容类型字符串,base64,{base64_encode}normal
data:image/pngpayloadstring透传参数
不做任何处理,仅数据传输
注:最多 1048576个字符
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url,请求方法为 POST,当视频生成任务有状态变化时,Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态:
processing 任务处理中success 任务完成(如发送失败,回调三次)failed 任务失败(如发送失败,回调三次)application/json返回参数
idstring任务ID
statestring处理状态
可选值:
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码,具体见错误码表
creditsinteger该任务消耗的积分数量,单位:积分
payloadapplication/json返回参数
task_idstringVidu 生成的任务ID
statestring处理状态
可选值:created 创建成功queueing 任务排队中processing 任务处理中success 任务成功failed 任务失败
storystring本次调用的模板成片参数
本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
creationsarray生成物结果
idstring生成物id,用来标识不同的生成物
urlstring生成物URL, 24小时有效期
cover_urlstring生成物封面,24小时有效期
watermarked_urlstringimagesstring本次调用的图像参数
payloadstring本次调用时传入的透传参数
creditsinteger本次调用使用的积分数
created_atstring任务创建时间
带水印的生成物url,24小时有效期
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/template-story' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"story": "choose_one_accept_value",
"images": "data:image/png",
"payload": "string",
"callback_url": "string"
}'{
"task_id": "your_task_id_here",
"state": "created",
"story": "your_choose_value",
"images": ["input_your_images"],
"payload":"",
"credits":credits_number,
"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"
}
]
}