一键解决方案
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}imagesstring*需要生成广告成片的商品图、模特图（可选）等
注1：支持传入图片 Base64 编码或图片URL（确保可访问）；
注2：支持输入 1\~7 张图；
注3：图片支持 png、jpeg、jpg、webp格式；
注4：图片比例需要小于 1:4 或者 4:1 ；
注5：图片大小不超过 50 MB；
注6：请注意，http请求的post body不超过 20MB，且编码必须包含适当的内容类型字符串，base64,{base64_encode}
注7：首张商品图为正面展示的效果最好normal
data:image/pngpromptstring用户提示词
生成视频的文本描述。
注1：字符长度不能超过 2000 个字符
durationinteger时长，8～60s，默认为15s
aspect_ratiostring输出比例，默认16:9
可选值 1:1，16:9，9:16
languagestring台词或旁白使用的语言，默认zh
可选值 zh，en
creativeboolean成片中是否需要创意片段，默认为false
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*idstring*成片id或子任务id
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*成片任务id，由创建任务接口创建成功返回
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}ad_one_click_task_idstring*一键成片主任务id
typestring*任务类型
generate_video 生视频任务
generate_narration 生成旁白任务
generate_bgm 生成背景音乐任务
storyboard_video_indexinteger分镜序号，type为generate_video时必传，用于指定想要修改的分镜编号
注意：分镜序号从0起始
promptstring*根据任务类型不同，有不同的含义：
generate_video 用于生成分镜的提示词
generate_narration 用于生成成片旁白的文本（音色不变）
generate_bgm 用于生成成片背景音乐的提示词
注：修改时，时长不变
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
payloadstringCallback 透传参数
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}ad_one_click_task_idstring*一键成片主任务id（通过创建任务接口获取）
video_task_idsstring*视频任务id列表，必须与原主任务的分镜数量相同
bgm_task_idstring*背景音乐任务id
narration_task_idstring*旁白任务id
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
payloadstringCallback 透传参数
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/ad-one-click' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"images": "data:image/png",
"prompt": "",
"duration": 15,
"aspect_ratio": "16:9",
"language": "zh",
"creative": true,
"callback_url": "string"
}'{
"task_id": "your_task_id_here",
"state": "created",
"images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"],
"prompt": "",
"duration": 15,
"aspect_ratio": "16:9",
"language": "zh",
"credits":credits_number
}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": 400,
"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"
}
],
"progress":90
}curl --request GET \
--url 'https://api.vidu.cn/ent/v2/ad-one-click/{id}' \
--header 'Authorization: Token {your api key}'{
"id": "891100896237203456",
"err_code": "",
"state": "success",
"data_records": {
"storyboards": [
{
"stroyboard_id": 0,
"records": [
{
"id": "891101095923822592",
"type": "generate_video",
"prompt": "string",
"creation_url": "string",
"state": "success",
"err_code": ""
},
{
"id": "891101095923822593",
"type": "generate_video",
"prompt": "string",
"creation_url": "string",
"state": "success",
"err_code": ""
},
]
},
{
"stroyboard_id": 1,
"records": [
{
"id": "891101095923822594",
"type": "generate_video",
"prompt": "string",
"creation_url": "string",
"state": "success",
"err_code": ""
}
]
},
{
"stroyboard_id": 2,
"records": [
{
"id": "891101095923822595",
"type": "generate_video",
"prompt": "string",
"creation_url": "string",
"state": "success",
"err_code": ""
}
]
}
],
"narration_records": [
{
"id": "891101095923822596",
"type": "generate_video",
"prompt": "string",
"creation_url": "string",
"state": "success",
"err_code": ""
}
],
"bgm_records": [
{
"id": "891101095923822597",
"type": "generate_video",
"prompt": "string",
"creation_url": "string",
"state": "success",
"err_code": ""
}
],
"completed_creation_records": [
{
"id": "891100914109132807",
"state": "success",
"params": {
"video_task_ids": [
"891101095923822592",
"891101095923822593",
"891101095923822594",
"891101095923822595",
],
"bgm_task_id": "891101095923822597",
"narration_task_id": "891101095923822596"
},
"creation_url": "string"
"err_code": ""
}
]
}
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/ad-one-click/edit' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"ad_one_click_task_id": "123",
"type": "generate_video",
"storyboard_video_index": 0,
"prompt": "your_prompt",
"callback_url": "string",
"payload": "string"
}'{
"ad_one_click_task_id":"your_ad_one_click_task_id",
"sub_task_id": "new_sub_task_id",
"state": "success",
"err_code": "",
"credits": 400
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/ad-one-click/compose' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"ad_one_click_task_id": "123",
"video_task_ids": [
"your_sub_task_id_1",
"your_sub_task_id_2",
"your_sub_task_id_3"
],
"bgm_task_id": "your_bgm_id_1",
"narration_task_id": "your_narration_id_1",
"callback_url": "string",
"payload": "string"
}'{
"ad_one_click_task_id":"your_task_id",
"compose_sub_task_id": "new_id",
"state": "success",
"credits": 400
}application/json返回参数
task_idstring本次任务vidu生成的任务id
statestring任务状态
可选值：
created创建成功
queueing任务排队中
processing任务处理中
success任务成功
failed任务失败
imagesstring本次成片中使用的图片
promptstring本次成片中用户输入的提示词
durationapplication/json返回参数
ad_one_click_task_idstring一键成片主任务id
sub_task_idstring本次编辑的任务id，可在查询生成物接口中获取任务状态
statestring任务状态
created创建成功
queueing任务排队中
processing任务处理中
success任务成功
failed任务失败
creditsinteger本次成片消耗的积分点数
application/json返回参数
ad_one_click_task_idstring一键成片主任务id
compose_sub_task_idstring本次重新合成的任务id, 可在查询生成物接口中获取任务状态
statestring任务状态
created创建成功
queueing任务排队中
processing任务处理中
success任务成功
failed任务失败
creditsinteger本次成片消耗的积分点数
application/json返回参数
idstring任务ID
statestring处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码，具体见错误码表
creditsinteger该任务消耗的积分数量，单位：积分
payloadstring本次任务调用时传入的透传参数
bgmboolean本次任务调用是否使用bgm
off_peakboolean本次任务调用是否使用错峰模式
progressinteger任务生成进度
creationsarray生成物结果
idstring生成物id，用来标识不同的生成物
urlstring生成物URL， 一个小时有效期
cover_urlstring生成物封面，一个小时有效期
watermarked_urlstringapplication/json返回参数
idstring本次成片任务id
err_codestring错误码
statestring任务状态
created创建成功
queueing任务排队中
processing任务处理中
success任务成功
failed任务失败
data_recordsobject子任务集合
storyboardsstring分镜任务记录
narration_recordsstring旁白任务记录
bgm_recordsstring背景音乐任务记录
completed_creation_recordsstring合成成片任务记录
stroyboard_idinteger分镜序号，从0开始，例如 0，1，2，3
recordsarray当前分镜序号的所有视频任务记录
idstring子任务唯一id
statestring任务状态
created创建成功
queueing任务排队中
processing任务处理中
success任务成功
failed任务失败
err_codestring错误码
typestring任务类型
generate_video 生视频任务
generate_narration 生成旁白任务
generate_bgm 生成背景音乐任务
promptstring根据任务类型不同，有不同的含义：
generate_video 用于生成分镜的提示词
generate_narration 旁白内容
generate_bgm 用于生成背景音乐的提示词
creation_urlstring生成物url
idstring子任务唯一id
statestring任务状态
created创建成功
queueing任务排队中
processing任务处理中
success任务成功
failed任务失败
err_codestring错误码
creation_urlstring生成物url
paramsobject参数信息
video_task_idsstring参与合成的视频任务id列表
bgm_task_idstring参与合成的bgm任务id
bgm_task_idstring参与合成的旁白任务id
带水印的生成物url，一小时有效期
本次成片生成的视频时长
aspect_ratiostring本次成片的视频比例
languagestring本次成片中旁白/台词生成的语言
creditsinteger本次成片消耗的积分点数