认证
authorization string 必填
所有 API 均使用 Bearer Token 鉴权
获取 API Key:
访问 API Key 管理页面 获取 API Key
用法:
将以下 Header 添加到请求中:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的客户模型 ID。
值: vidu-cn-start-end2video-viduq1
model string 必填
上游 Vidu 模型值,固定使用 viduq1。
images array[string] 必填
首尾帧图片。传入 2 张图片,第一张为首帧,第二张为尾帧。
prompt string
生成首尾帧过渡视频的文本描述。
duration integer
视频时长,单位秒。
resolution string
视频分辨率,例如 720p。
movement_amplitude string
运动幅度,常用取值包括 auto、small、medium、large。
bgm boolean
支持时是否添加背景音乐。
callback_url string
异步任务回调地址。
轮询
由于结果生成需要时间,您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息,仅在状态为 failed 时存在。
code
string错误码
message
string详细错误信息
output array
生成结果,成功时存在。
content
array生成的资源内容列表
type
string资源类型。
值:
videourl
string生成资源 URL。文本类工具接口可能返回文本字段而不是 URL。
jobId
string上游任务 ID。
usage object
使用统计,成功时存在。
cost
string总费用(美元)。
discount
number折扣金额。
metadata object
元数据信息。