⌘K

Vidu 一键生成电商成片

vidu-cn-ad-one-click

创建、查询、编辑和合成电商一键成片任务。

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

访问 API Key 管理页面 获取 API Key

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的客户模型 ID。

值: vidu-cn-ad-one-click

工作流操作模型 string 必填

该工作流的主要客户模型或操作 ID。

prompt string

工作流文本指令。

images array[string]

工作流使用的输入图片或素材。

callback_url string

异步任务回调地址。

工作流接口

vidu-cn-ad-one-click

创建电商成片任务。

vidu-cn-ad-one-click/{id}

查询电商成片任务和子任务列表。

vidu-cn-ad-one-click/{id}/creations

查询成片或单个分镜的生成结果。

vidu-cn-ad-one-click/edit

编辑分镜、旁白或背景音乐。

vidu-cn-ad-one-click/compose

合成最终电商成片。

轮询

由于结果生成需要时间，您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息，仅在状态为 failed 时存在。

code string

错误码

message string

详细错误信息

output array

生成结果，成功时存在。

content array

生成的资源内容列表

type string

资源类型。

值: video

url string

生成资源 URL。文本类工具接口可能返回文本字段而不是 URL。

jobId string

上游任务 ID。

usage object

使用统计，成功时存在。

cost string

总费用（美元）。

discount number

折扣金额。

metadata object

元数据信息。