Skip to main content
Describe a shot in text, submit it to POST /v1/videos, and poll the returned video until it’s ready. No source image or video is required — this is the H3 Video Generation text-to-video mode, a Viggle-optimized MiniMax H3 capability separate from the character+motion Video Remix flow. Every generated video includes native audio. Set VIGGLE_API_KEY and run the example below as-is — it needs no other input.

What you need

  • An API key from the Viggle Dashboard, exported as VIGGLE_API_KEY
  • A non-empty text prompt
  • A quality choice: low for faster generation and quicker iteration, or high for higher-fidelity output — both are billed at the same $0.01/sec rate

Generate and poll the video

Response

The create request answers immediately with status: "queued" and no video_url yet — it’s an acceptance acknowledgment, not the final result. Poll GET /v1/videos/{video_id} every 3–5 seconds until status is ready, failed, or cancelled, then read video_url — a signed link, valid for 1 hour and re-signed on every read. duration_s (3–15, default 5), resolution (default 768p), and aspect_ratio (default 16:9) are all optional; prompt and quality are not. See Pricing and retention — H3 Video is billed at $0.01 per generated second regardless of quality, resolution, or aspect_ratio.

Generate Video (from Text)

See every field and the full response shape.