Prerequisites
- A Viggle API key (get one here)
- A reference image (PNG or JPG)
- A driving video (MP4)
Workflow
Render
Upload
ref_image and driving_video to start a job. 1 credit/sec of output.Poll for completion
Poll every 3-5 seconds. No auth required for the status endpoint.
Download
When the job is complete, use the
cdn_url from the status response to download the video.Render options
Pass additional fields alongsideref_image and driving_video:
Selecting a model
V3_Preview is the default. Pass model=V4_Preview to use the V4 model:
Using URL inputs
Pass URLs instead of uploading files. The server fetches the content:On-Demand vs Preprocessing
What’s next?
Preprocessing Guide
Pre-create assets for 3x faster renders
Import Templates
Use pre-made templates from viggle.ai
Render Options
Background mode and more

