Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称支持的模型:
  • viduq3-mix - 综合画质王,智能转场更强,支持 1 秒短视频
  • viduq3 - 默认首选,镜头切换更聪明
如何选择:日常用 viduq3;要冲画质或要做 1-2 秒动效就用 viduq3-mix
boolean
默认值:"false"
是否在提交视频任务前执行内容审核。
  • true:使用 omni-moderation-latest 审核提示词和输入图片
  • false 或不传:不发起审核请求,不增加审核成本与延迟(默认)
string
必填
文本提示词,最长 5000 个字符描述动作和镜头,不要描述外观(外观由参考图片决定)。示例:"圣诞老人与熊在湖边相拥"
array<url>
必填
参考图片 URL 数组,1-7 张支持公网可访问的图片 URL(http:// 或 https://)示例:["https://example.com/santa.png", "https://example.com/bear.png"]
  • 数量:1-7 张
  • 支持格式:PNG、JPEG、JPG、WebP
  • 最小尺寸:128×128
  • 宽高比:1:4 ~ 4:1 之间
  • 单张大小:≤ 50MB
  • 必须是公网可访问的 URL
integer
默认值:"5"
视频时长(秒)
  • viduq3-mix116
  • viduq3316
默认值:5
viduq3 最低支持 3 秒,viduq3-mix 最低支持 1 秒。请根据所选模型传入有效时长。
string
默认值:"720p"
视频分辨率
  • viduq3-mix720p(默认)/ 1080p
  • viduq3540p / 720p(默认)/ 1080p
viduq3-mix 不支持 540p,请使用 720p1080p
string
默认值:"16:9"
视频宽高比可选值:
  • 16:9 - 横屏(默认)
  • 9:16 - 竖屏
  • 4:3 - 传统比例
  • 3:4 - 竖版传统比例
  • 1:1 - 方形
integer
随机种子,用于控制生成内容的随机性不传则随机生成。
相同参数下使用相同 seed 值会生成类似的结果,但不保证完全一致。

模型对比

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:viduq3 基础参考生视频

场景 2:viduq3-mix 高画质参考生视频

查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。