一键解决方案
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：请注意，base64 decode之后字节长度需要小于10M，且编码必须包含适当的内容类型字符串，base64,(base64_encode)normal
data:image/pngpromptstring用户提示词
生成成片的文本描述。
注1：字符长度不能超过 3000 个字符
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*成片id或子任务id
Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*idstring*任务id，放在path路径中
job_idstring*Authorizationstring*将 {your api key} 替换为您的 token
Token {your api key}idstring*idstring*任务id，放在path路径中
job_idsstring*aspect_ratiostring输出比例，默认16:9
可选值 1:1、16:9、9:16、4:3、3:4
durationinteger*时长，1～180s
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
payloadstring透传参数
不做任何处理，仅数据传输
注：最多1048576个字符
要编辑的分镜id
promptstring*用户提示词
生成mv视频的文本描述。
注1：字符长度不能超过 3000 个字符
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
要合成的分镜列表
callback_urlstringCallback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
application/json返回参数
idstring任务ID
statestring处理状态
可选值：
created 创建成功
processing 任务处理中
success 任务成功
failed 任务失败
err_codestring错误码，具体见错误码表
err_msgstring错误相关信息
created_atapplication/json返回参数
idstring本次任务vidu生成的任务id
application/json返回参数
idstring本次任务vidu生成的任务id
application/json返回参数
idstring本次任务vidu生成的任务id
创建时间
signed_urlstring成片生成视url(小于3分钟有效)
job_recordsarray分镜列表+合成视频
typestring可选值：
generate_video 视频分镜
compose 合成所有分镜
indexinteger分镜索引
jobsarray单个分镜修改历史
jobs.idstring子任务id
jobs.typestringgenerate_video/compose
jobs.statestring处理状态
可选值：
created 创建成功
processing 任务处理中
success 任务成功
failed 任务失败
jobs.signed_urlstring分镜或合成生成视 url
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"images": "data:image/png",
"prompt": "",
"aspect_ratio": "16:9",
"duration": 15,
"callback_url": "string",
"payload": "string"
}'{
"id": "your_id_here"
}curl --request GET \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}' \
--header 'Authorization: Token {your api key}'{
"id": "901243326567555072",
"type": "one_click",
"creator_id": "869085108764676096",
"state": "success",
"input": "",
"job_records": [
{
"type": "generate_video",
"jobs": [
{
"id": "901245331704909824",
"type": "generate_video",
"input": "",
"output": "",
"state": "success",
"created_at": "2025-12-24T02:59:06.937309Z",
"updated_at": "2025-12-24T02:59:35.473978Z",
"err_code": "",
"err_msg": "",
"signed_url": "your_url",
"mv_generate_video_input": {
"duration": 3,
"prompt": "2.5d建模风格，明亮活泼的色调，极光在北极圈上空舞动，粒子光效闪烁，镜头缓慢推进，营造神秘又欢快的氛围。",
"lyric_text": "前奏",
"signed_images": []
},
"index": 0
}
],
"index": 0
},
{
"type": "compose",
"jobs": [
{
"id": "901245503243554816",
"type": "compose",
"input": "",
"output": "",
"state": "success",
"created_at": "2025-12-24T02:59:47.431993Z",
"updated_at": "2025-12-24T03:00:13.727780Z",
"err_code": "",
"err_msg": "",
"signed_url": "your_url",
"index": 0
}
],
"index": 0
}
],
"created_at": "2025-12-24T02:51:34.070650Z",
"updated_at": "2025-12-24T03:00:13.734086Z",
"err_code": "",
"err_msg": "",
"signed_url": "your_url"
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click/string/edit' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"id": "string",
"job_id": "901334076999344129",
"prompt": "2.5D建模风格，欢快愉悦氛围，近景，男主角在海角天边的沙滩上跳舞，海浪轻拍脚踝，镜头跟随她的旋转动作，展现她笑容和活力。",
"callback_url": "string"
}'{
"id": "your_job_id_here"
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click/string/compose' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"id": "string",
"job_ids": [
"id1",
"id2",
"id3",
"id4",
"id5",
"id6"
],
"callback_url": "string"
}'{
"id": "your_job_id_here"
}