POST /v1/videos 提交首帧、尾帧和文本提示词,再轮询视频直至就绪。两张图片均可分别选择文件上传或 URL。提供尾帧时必须同时提供首帧,prompt 仍然必填。这是 H3 视频的四种模式之一;其他模式见文本生成视频、首帧生成视频和参考素材生成视频。
设置环境变量 VIGGLE_API_KEY,并准备下方示例所需的首尾帧图片。
准备工作
- 在 Viggle 控制台创建 API 密钥,并导出为
VIGGLE_API_KEY。 - 非空文本提示词,以及
quality选项:low或high。
示例中的
https://assets.viggle.ai/samples/first-frame.png 和 .../last-frame.png 是占位地址。请替换为自己的 first_frame_image/first_frame_image_url 和 last_frame_image/last_frame_image_url,或使用 Viggle 正式发布的示例素材。生成并轮询视频
响应
status: "queued",表示请求已受理,并非最终结果。每 3–5 秒轮询 GET /v1/videos/{video_id},直到 status 为 ready、failed 或 cancelled。就绪后读取 video_url:该签名链接有效期为 1 小时,每次读取都会重新签名。仅提供尾帧而未提供首帧会返回 400 INVALID_REQUEST,错误信息为 “a last frame requires a first frame”;同一位置同时提供文件和 URL 也会返回 400 INVALID_REQUEST,例如 “supply only one of first_frame_image or first_frame_image_url”。
费用见计费与保留期限:相同 quality 和 duration_s 下,图片条件生成与纯文本生成价格相同。
从首尾帧和文本生成视频
查看全部字段、两种上传方式和常见校验错误。

