认证
authorization string 必需
所有 API 都需要通过 Bearer Token 进行身份验证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方式:
添加到请求头:
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: viduq2_turbo_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
string错误码
message
string详细错误消息
output array
生成结果. 仅在 status 为 completed 时出现
type
string资源类型
值:
video
url
string生成的视频 URL（已处理并上传至 CDN）
jobId
string远程任务 ID
usage object
使用统计信息. 仅在 status 为 completed 时出现
model
string使用的模型名称（viduq2-turbo）
duration
integer延长时长（秒）
resolution
string视频分辨率
credits
integer消耗的积分数
metadata object
元数据信息
错误码
| 错误码 | 描述 |
|---|---|
| 008013001 | 缺少视频参数（video_creation_id 或 video_url 至少需要提供一个） |
| 008013002 | 视频 URL 格式无效（必须是 HTTP 或 HTTPS URL） |
| 008013003 | 视频创建 ID 格式无效（必须是非空字符串） |
| 008013004 | 提示词长度无效（不超过 2000 字符） |
| 008013005 | 延长时长无效（必须是 1-7 秒之间的整数） |
| 008013006 | 分辨率无效（必须是 540p, 720p 或 1080p） |
| 008013007 | 参考图像数量无效（只允许 1 张参考图像） |
| 008013008 | 图像格式无效（必须是 URL 或 base64 编码） |
| 008013009 | 图像大小无效（不超过 50MB, base64 解码后不超过 10MB） |
| 008013010 | 载荷长度无效（不超过 1048576 字符） |
| 008013011 | 回调 URL 格式无效（必须以 http:// 或 https:// 开头） |
| 008013095 | 内部生成错误 |
| 008013096 | 结果解析异常 |
| 008013097 | HTTP 错误响应 |
| 008013098 | 状态检查异常 |
| 008013099 | 任务创建异常 |