一键生成通用成片

一键生成通用成片 | Vidu API

当前页面

当前页面

解决方案

POST https://api.vidu.cn/ent/v2/one-click/general_one_click

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	必传	类型	说明
images	是	Array[String]	用户生成时需要使用的媒体、物品或风格图片注1：支持传入 Base64 编码或图片 URL（缺省可访问）；注2：支持输入 1~7 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1；注5：图片大小不超过 50 MB；注6：请注意，base64 decode之后字节长度需要小于10M，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,(base64_encode)`
prompt	可选	string	用户提示词生成成片的文本描述。注1：字符长度不能超过 3000 个字符
aspect_ratio	可选	string	输出比例，默认16:9 可选值 1:1、16:9、9:16、4:3、3:4
duration	是	Int	时长，1～180s
callback_url	可选	String	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法
payload	可选	String	透传参数不做任何处理，仅数据传输注：最多1048576个字符

字段	类型	说明
id	string	本次任务vidu生成的任务id

{
  "id": "your_id_here"
}

GET https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

参数名称	类型	必填	参数描述
id	String	是	成片id或子任务id

字段	子字段		类型	描述
id			String	任务ID
state			String	处理状态可选值： created 创建成功 processing 任务处理中 success 任务成功 failed 任务失败
err_code			String	错误码，具体见错误码表
err_msg			String	错误相关信息
created_at			String	创建时间
signed_url			String	成片生成视url(小于3分钟有效)
job_records			Array	分镜列表+合成视频
	type		String	可选值： generate_video 视频分镜 compose 合成所有分镜
	index		Int	分镜索引
	jobs		Array	单个分镜修改历史
		id	String	子任务id
		type	String	generate_video/compose
		state	String	处理状态可选值： created 创建成功 processing 任务处理中 success 任务成功 failed 任务失败
		signed_url		分镜或合成生成视 url

{
    "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"
}

POST https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}/edit

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	必传	类型	说明
id	是	String	任务id，放在path路径中
job_id	是	String	要编辑的分镜id
prompt	是	string	用户提示词生成mv视频的文本描述。注1：字符长度不能超过 3000 个字符
callback_url	可选	String	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	类型	说明
id	string	本次任务vidu生成的任务id

{
  "id": "your_job_id_here"
}

POST https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}/compose

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	必传	类型	说明
id	是	String	任务id，放在path路径中
job_ids	是	String	要合成的分镜列表
callback_url	可选	String	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	类型	说明
id	string	本次任务vidu生成的任务id

{
  "id": "your_job_id_here"
}

解决方案

POST https://api.vidu.cn/ent/v2/one-click/general_one_click

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	必传	类型	说明
images	是	Array[String]	用户生成时需要使用的媒体、物品或风格图片注1：支持传入 Base64 编码或图片 URL（缺省可访问）；注2：支持输入 1~7 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1；注5：图片大小不超过 50 MB；注6：请注意，base64 decode之后字节长度需要小于10M，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,(base64_encode)`
prompt	可选	string	用户提示词生成成片的文本描述。注1：字符长度不能超过 3000 个字符
aspect_ratio	可选	string	输出比例，默认16:9 可选值 1:1、16:9、9:16、4:3、3:4
duration	是	Int	时长，1～180s
callback_url	可选	String	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法
payload	可选	String	透传参数不做任何处理，仅数据传输注：最多1048576个字符

字段	类型	说明
id	string	本次任务vidu生成的任务id

{
  "id": "your_id_here"
}

GET https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

参数名称	类型	必填	参数描述
id	String	是	成片id或子任务id

字段	子字段		类型	描述
id			String	任务ID
state			String	处理状态可选值： created 创建成功 processing 任务处理中 success 任务成功 failed 任务失败
err_code			String	错误码，具体见错误码表
err_msg			String	错误相关信息
created_at			String	创建时间
signed_url			String	成片生成视url(小于3分钟有效)
job_records			Array	分镜列表+合成视频
	type		String	可选值： generate_video 视频分镜 compose 合成所有分镜
	index		Int	分镜索引
	jobs		Array	单个分镜修改历史
		id	String	子任务id
		type	String	generate_video/compose
		state	String	处理状态可选值： created 创建成功 processing 任务处理中 success 任务成功 failed 任务失败
		signed_url		分镜或合成生成视 url

{
    "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"
}

POST https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}/edit

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	必传	类型	说明
id	是	String	任务id，放在path路径中
job_id	是	String	要编辑的分镜id
prompt	是	string	用户提示词生成mv视频的文本描述。注1：字符长度不能超过 3000 个字符
callback_url	可选	String	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	类型	说明
id	string	本次任务vidu生成的任务id

{
  "id": "your_job_id_here"
}

POST https://api.vidu.cn/ent/v2/one-click/general_one_click/{id}/compose

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

字段	必传	类型	说明
id	是	String	任务id，放在path路径中
job_ids	是	String	要合成的分镜列表
callback_url	可选	String	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	类型	说明
id	string	本次任务vidu生成的任务id

{
  "id": "your_job_id_here"
}

搜索文档

搜索文档