Swap any character into any video.
One API call.
Trusted by builders at
How It Works
One API Call.
Three Steps to Animation.
Create Character
Upload a reference photo. The API extracts the subject and prepares it for animation.
POST /v1/charactersPick a Template
Choose from thousands of motion templates, or upload your own driving video.
POST /v1/rendersRender
The API combines character + template and returns an animated MP4 in under 20 seconds.
→ MP4 ready# outlinePOST /v1/charactersPOST /v1/renders→ MP4 ready
# 1 — Create a character from a photo POST /v1/characters photo_url "https://example.com/avatar.jpg"# 2 — Kick off a render POST /v1/renders character_id "char_abc123" template_id "tpl_dance_042"# 3 — Response status 200 OK video_url https://cdn.viggle.ai/render_f7e2.mp4
Use Cases
What You Can Build
- 01Let users upload a selfie and appear in trending dance or meme templates
- 02Powerful "put yourself in the video" features
- 03Bulk-generate short-form content at scale
Simple, Transparent Pricing
Pay per second of animation. No seat licenses, no commitment.
- Pay as you go — no commitment
- Results in <20 seconds
- Auto top-up keeps your balance funded
- Upload from anywhere
- Scales to millions of renders
Enterprise: unlimited, white-label, on-premise.
1 credit = 1 second.
Frequently Asked Questions
Common questions from developers integrating the Viggle API
The Viggle API swaps any character into any video. Upload a reference photo, choose a motion template (or provide your own driving video), and the API returns an MP4 with your character performing that motion. No specialist tools — one REST call.
A single front-facing photo for the character. For motion: a template ID from the Viggle marketplace, or your own driving video (any footage with a person in it). On-demand mode accepts photo + driving video in a single request.
An animated MP4. Set background_mode=transparent to receive a separate mask video for compositing in your own pipeline.
API key authentication. Generate your key from the portal at portal.viggle.ai. Pass it as a Bearer token in the Authorization header on every request.
You're charged 1 credit ($0.01) per second of animation per character. A 5-second clip with one character = $0.05. Multi-character scenes are billed per character. Auto top-up keeps your balance funded. Contact us about free trial credits.
Typically under 20 seconds. Progressive render mode (fMP4) lets you stream chunks via long-polling and start playing before the render finishes — useful for real-time UX.
Yes. On-demand mode lets you provide any video with a person in it as the motion source. The API extracts the motion and applies it to your character — no template ID needed.
Yes. Provide multiple character-to-person mappings in a single render request. Partial mapping is supported — people without a mapped character keep their original appearance in the output.