Skip to main content
Send a character image and driving video directly. No preprocessing, no stored assets — one API call to start rendering.

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 alongside ref_image and driving_video:
See Render Options for all available parameters.

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