Skip to main content
用文字描述镜头,提交到 POST /v1/videos,再轮询视频直至就绪。本流程无需源图片或视频,使用 H3 视频生成的文本模式,即经 Viggle 优化的 MiniMax H3 能力。角色加动作的视频重混使用另一套流程。所有生成视频均自带原生音频 设置 VIGGLE_API_KEY 后即可运行下方示例,无需其他输入素材。

准备工作

  • Viggle 控制台创建 API 密钥,并导出为 VIGGLE_API_KEY
  • 非空文本提示词。
  • quality 选项:low 生成更快,适合迭代;high 提供更高的保真度。两者均按 $0.01/秒计费。

生成并轮询视频

响应

创建请求立即返回 status: "queued",此时还没有 video_url,仅表示请求已受理。每 3–5 秒轮询 GET /v1/videos/{video_id},直到 statusreadyfailedcancelled。就绪后读取 video_url:签名链接有效期为 1 小时,每次读取都会重新签名。duration_s(3–15,默认 5)、resolution(默认 768p)和 aspect_ratio(默认 16:9)均可省略;promptquality 必填。 费用见计费与保留期限:H3 视频按生成时长收取 $0.01/秒,与 qualityresolutionaspect_ratio 无关。

从文本生成视频

查看全部字段和完整响应结构。