Skip to main content
上传参考视频并描述期望的镜头,即可生成延续参考素材主体或风格的新视频。向 POST /v1/videos 提交一次请求,再轮询 GET /v1/videos/{video_id} 获取成品。本 H3 视频模式自带原生音频,也支持参考图片;图片可单独使用,或与参考视频一起使用。

准备工作

  • Viggle 控制台创建 API 密钥,并导出为 VIGGLE_API_KEY
  • 将参考视频保存为运行示例目录下的 reference.mp4。视频长度须为 0.5–600 秒,分辨率至少为 64×64 像素,且宽高均为偶数。
  • cURL 示例需要安装 jq;Node 示例需要 Node.js 20+,并保存为 .mjs 文件;Python 示例需要通过 pip install requests 安装 requests
示例会上传本地文件,并请求生成 5 秒视频。请修改 prompt 来描述期望的镜头。promptquality 均为必填;low 适合快速迭代,high 提供更高的保真度。

生成并轮询视频

响应

创建请求会立即返回视频 ID。示例每 5 秒轮询一次,在 statusready 时输出 video_url;遇到 failedcancelled 或轮询超时则停止。若轮询超时,可使用同一 ID 继续调用获取视频 打开输出的 URL 即可查看或下载视频。签名链接有效期为 1 小时,再次获取视频即可得到新的链接。

使用 URL 或参考图片

  • 托管视频:reference_video 文件字段替换为 reference_video_url,填写可公开访问的视频 URL。文件和 URL 两种方式合计最多提供 1 个参考视频。
  • 添加图片: 在视频之外加入 reference_image 文件或 reference_image_url 字段。可重复这些字段,图片总数最多为 4 张。
  • 仅使用图片: 省略视频,提供至少 1 张参考图片,并保留 promptquality
必须包含至少一个参考字段;全部省略会进入文本生成视频模式。参考字段不能与首尾帧字段或 Viggle-Animate 的驱动视频、角色图片字段混用。
duration_s 控制生成视频的长度(3–15 秒,默认 5),与参考视频的长度无关。生成费用见计费与保留期限

从参考视频或图片生成视频

查看全部参数、参考图片示例和校验错误。

使用 Viggle-Animate

将驱动视频的动作应用到角色图片。