⌘K

Vidu 一键生成 AI-MV

vidu-cn-one-click/mv

创建、查询、编辑和合成 AI-MV 一键成片任务。

认证

authorization string 必填

所有 API 均使用 Bearer Token 鉴权

获取 API Key：

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

用法：

将以下 Header 添加到请求中：

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的客户模型 ID。

值: vidu-cn-one-click/mv

工作流操作模型 string 必填

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

prompt string

工作流文本指令。

images array[string]

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

callback_url string

异步任务回调地址。

工作流接口

vidu-cn-one-click/mv

创建 AI-MV 任务。

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

查询 AI-MV 任务。

vidu-cn-one-click/mv/{id}/edit

编辑 AI-MV 任务。

vidu-cn-one-click/mv/{id}/compose

合成最终 AI-MV。

轮询

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

初始响应只返回任务 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

元数据信息。