认证
authorization string 必需
所有 API 均使用 Bearer Token 鉴权
获取 API Key：
访问 API Key 管理页面 获取 API Key
用法：
将以下 Header 添加到请求中：
Authorization: Bearer YOUR_API_KEY参数
model string 必需
请求使用的模型 ID
值: viduq2_pro_reference
images array<string> 必需
图像参考, 支持上传 1 - 7 张图片, 模型将以传入图片中的主题为参考生成具备主体一致的视频
注 1: 使用本模型时, 如果不上传视频则支持上传 1 - 7 张图, 如果上传视频则支持 1 - 4 张图
注 2: 支持传入图片 Base64 编码或图片 URL（确保可访问）
注 3: 图片支持 png、jpeg、jpg、webp 格式
注 4: 图片像素不能小于 128x128, 且比例需要小于 1:4 或者 4:1, 且大小不超过 50MB
注 5: 请注意, http 请求的 post body 不超过 20MB, 且编码必须包含适当的内容类型字符串, 例如：data:image/png;base64,{base64_encode}
videos array<string> 必需
视频参考, 支持上传 1 - 2 个视频, 模型将以传入视频作为参考生成具备主体一致的视频
注 1: 使用视频参考功能时, 最多支持上传 1 个 8 秒视频或 2 个 5 秒视频
注 2: 视频支持 mp4、avi、mov 格式
注 3: 视频像素不能小于 128x128, 且比例需要小于 1:4 或者 4:1, 且大小不超过 100MB
注 4: 请注意, base64 decode 之后的字节长度需要小于 20MB, 且编码必须包含适当的内容类型字符串, 例如：data:video/mp4;base64,{base64_encode}
prompt string 必需
文本提示词, 用于描述要生成的视频内容
限制: 字符长度不能超过 5000 个字符
bgm boolean
是否为生成的视频添加背景音乐
传 true 时系统将从预设 BGM 库中自动挑选合适的音乐并添加；不传或为 false 则不添加 BGM
BGM 不限制时长, 系统根据视频时长自动适配
注意: 本模型的 duration 为 9 秒或 10 秒时, bgm 参数不生效
可选值: true, false
默认值: false
duration integer
视频时长参数
可选值: 0 - 10（0 秒为自动判断时长）
默认值: 5
seed integer
随机种子, 默认不传或传 0 时会使用随机数, 手动设置时使用设置的种子
aspect_ratio string
画面比例
可选值: 16:9, 9:16, 4:3, 3:4, 1:1
默认值: 16:9
resolution string
分辨率参数
可选值: 540p, 720p, 1080p
默认值: 720p
payload string
透传参数, 不做任何处理, 仅数据传输
限制: 最多 1048576 个字符
off_peak boolean
注意: 暂不可用
错峰模式
true: 错峰生成视频
false: 即时生成视频
注 1: 错峰模式消耗的积分更低
注 2: 错峰模式下提交的任务会在 48 小时内生成, 未能完成的任务会被自动取消并返还该任务积分
注 3: 您也可以手动取消错峰任务
注 4: 音视频直出功能不支持错峰模式
可选值: true, false
默认值: false
watermark boolean
是否添加水印
true: 添加水印
false: 不添加水印
注 1: 目前水印内容固定, 内容为 AI 生成, 默认不添加
注 2: 可通过 watermarked_url 字段获取带水印视频内容
可选值: true, false
默认值: false
wm_position integer
水印位置, 表示水印在画面中的位置
1: 左上角
2: 右上角
3: 右下角
4: 左下角
默认值: 3
wm_url string
水印内容图片 URL, 不传时使用默认水印（内容由 AI 生成）
meta_data string
元数据标识
callback_url string
回调地址
轮询
由于结果生成需要时间，您需要在创建任务后轮询任务状态
初始响应只返回任务 ID 和初始状态等信息，最终生成结果需通过使用该任务 ID 轮询任务状态接口获取
轮询请求与响应示例见右侧
响应格式
error object
错误信息. 仅在 status 为 failed 时出现
code
integer错误码
error_message
string详细错误消息
output array
生成结果. 仅在 status 为 completed 时出现
content
array生成的内容列表
type
string资源类型
值:
videourl
string生成内容的 URL
usage object
使用统计信息. 仅在 status 为 completed 时出现
cost
string总费用（美元）
discount
number折扣金额
metadata object
元数据信息