Skip to main content
POST /v1/videos 提交首帧图片和文本提示词,再轮询视频直至就绪。即使提供了图片,prompt 仍然必填,用于描述画面如何运动。这是 H3 视频的四种模式之一;其他模式见文本生成视频首尾帧生成视频参考素材生成视频 设置环境变量 VIGGLE_API_KEY,并准备下方示例所需的首帧图片。

准备工作

  • Viggle 控制台创建 API 密钥,并导出为 VIGGLE_API_KEY
  • 非空文本提示词,以及 quality 选项:lowhigh
示例中的 https://assets.viggle.ai/samples/first-frame.png 是占位地址。请替换为自己的 first_frame_image/first_frame_image_url,或使用 Viggle 正式发布的示例素材。

生成并轮询视频

响应

创建请求立即返回 status: "queued",表示请求已受理,并非最终结果。每 3–5 秒轮询 GET /v1/videos/{video_id},直到 statusreadyfailedcancelled。就绪后读取 video_url:该签名链接有效期为 1 小时,每次读取都会重新签名。first_frame_image(文件上传)和 first_frame_image_url 必须二选一,同时提供会返回 400 INVALID_REQUEST 费用见计费与保留期限:相同 qualityduration_s 下,图片条件生成与纯文本生成价格相同。

从首帧和文本生成视频

查看全部字段、两种上传方式和常见校验错误。