认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证.
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方式:
添加到请求头:
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: viduq2_pro_extend
video_creation_id string
vidu 视频 ID，与 video_url 必填一个
video_url string
任意视频 URL，与 video_creation_id 必填一个
注意: 传入的视频时长不能低于 4 秒，不能超过 1 分钟
images array
延长到尾帧的参考图像，模型将以此参数中传入的图片为尾帧画面来延长视频
格式要求：
支持传入图片 Base64 编码或图片 URL（确保可访问）
只支持输入 1 张图
支持格式：png, jpeg, jpg, webp
图片比例需要小于 1:4 或者 4:1
图片大小不超过 50MB
请注意, http 请求的 post body 不超过 20MB, 且编码必须包含适当的内容类型字符串. 例如：data:image/png;base64,{base64_encode}
prompt string
延长提示词，用来控制延长的视频内容
resolution string
视频分辨率
可选值: 540p, 720p, 1080p
默认值: 720p
duration integer
延长时长, 单位为秒
可选值: 1 - 7
默认值: 5
watermark boolean
是否添加水印. 当为 true 时添加水印；当为 false 时不添加水印
目前水印内容为固定, 内容由 AI 生成, 默认不加
可选值: true, false
默认值: false
wm_url string
水印内容, 此处为水印图片 URL，不添加水印则该参数无效
启用水印但不传自定义水印 URL 时, 使用默认水印：内容由 AI 生成
wm_position string
水印位置，不添加水印则该参数无效
可选值: top_left（左上）, top_right（右上）, bottom_right（右下）, bottom_left（左下）
默认值: bottom_left
meta_data string
元数据标识, JSON 格式字符串, 透传字段
您可以自定义格式或使用示例格式. 示例如下：
{
"Label": "your_label",
"ContentProducer": "yourcontentproducer",
"ContentPropagator": "your_content_propagator",
"ProduceID": "yourproductid",
"PropagateID": "your_propagate_id",
"ReservedCode1": "yourreservedcode1",
"ReservedCode2": "your_reserved_code2"
}该参数为空时, 默认使用 vidu 生成的元数据标识
payload string
透传参数，不做任何处理, 仅数据传输，最多 1048576 个字符
callback_url string
回调 URL
轮询
由于视频生成需要时间, 您需要在创建后轮询任务状态
初始响应返回任务 ID 和初始状态. 必须通过轮询任务状态端点获取实际生成结果
响应格式
error object
错误信息. 仅在 status 为 failed 时出现
code
integer错误码
error_message
string详细错误消息
output array
生成结果. 仅在 status 为 completed 时出现
content
array生成的内容列表
type
string资源类型
url
string内容 URL
jobId
string作业 ID
usage object
使用统计信息. 仅在 status 为 completed 时出现
model
string模型名称
duration
integer视频时长
resolution
string视频分辨率
credits
integer消耗点数
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 008012001 | 视频参数缺失 |
| 008012002 | 视频 URL 无效 |
| 008012003 | 视频创建 ID 无效 |
| 008012004 | 提示词长度无效 |
| 008012005 | 时长无效 |
| 008012006 | 分辨率无效 |
| 008012007 | 图像数量无效 |
| 008012008 | 图像格式无效 |
| 008012009 | 图像大小无效 |
| 008012010 | 透传参数长度无效 |
| 008012011 | 回调 URL 无效 |
| 008012098 | 生成失败 |
| 008012099 | 服务不可用 |