Import Templates from Viggle

Import pre-made templates from viggle.ai instead of uploading your own videos.

Video templates — single-person scenes for rendering
Multi-person templates — contain tracked person UUIDs for each person in the video

Finding template IDs

Video templates
Multi-person templates

Single-person scenes from the viggle.ai homepage.

Browse templates on viggle.ai

Go to viggle.ai and browse the Hot Picks section.

Viggle homepage showing Hot Picks templates

Copy the template ID

Click the copy icon next to the template title.

Template detail page with copy ID button

Importing via the API

Single-person
Multi-person

import requests
API_KEY, BASE = "YOUR_API_KEY", "https://apis.viggle.ai"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

scene = requests.post(f"{BASE}/api/scenes/import", headers=headers,
    json={"template_uuid": "YOUR_TEMPLATE_UUID", "name": "My Imported Scene"}).json()
scene_id = scene["scene_id"]

const API_KEY = "YOUR_API_KEY", BASE = "https://apis.viggle.ai";

const scene = await fetch(`${BASE}/api/scenes/import`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_uuid: "YOUR_TEMPLATE_UUID",
    name: "My Imported Scene",
  }),
}).then(r => r.json());
const sceneId = scene.scene_id;

curl -X POST "https://apis.viggle.ai/api/scenes/import" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_uuid": "YOUR_TEMPLATE_UUID", "name": "My Imported Scene"}'

Render with the imported scene:

job = requests.post(f"{BASE}/api/render",
    headers={"Authorization": f"Bearer {API_KEY}"},
    data={"character_id": "YOUR_CHARACTER_ID", "scene_id": scene_id}).json()

const form = new URLSearchParams();
form.append("character_id", "YOUR_CHARACTER_ID");
form.append("scene_id", sceneId);
const job = await fetch(`${BASE}/api/render`, {
  method: "POST",
  headers: { Authorization: `Bearer ${API_KEY}` },
  body: form,
}).then(r => r.json());

curl -X POST "https://apis.viggle.ai/api/render" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "character_id=YOUR_CHARACTER_ID" -d "scene_id=SCENE_ID"

import requests
API_KEY, BASE = "YOUR_API_KEY", "https://apis.viggle.ai"
headers = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

scene = requests.post(f"{BASE}/api/scenes/import", headers=headers,
    json={"template_uuid": "YOUR_MULTI_TEMPLATE_UUID", "name": "Group Dance"}).json()
scene_id = scene["scene_id"]

for person_uuid in scene["character_uuids"]:
    print(f"  Person UUID: {person_uuid}")

const API_KEY = "YOUR_API_KEY", BASE = "https://apis.viggle.ai";

const scene = await fetch(`${BASE}/api/scenes/import`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_uuid: "YOUR_MULTI_TEMPLATE_UUID",
    name: "Group Dance",
  }),
}).then(r => r.json());

for (const personUuid of scene.character_uuids) {
  console.log(`  Person UUID: ${personUuid}`);
}

curl -X POST "https://apis.viggle.ai/api/scenes/import" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_uuid": "YOUR_MULTI_TEMPLATE_UUID", "name": "Group Dance"}'
# Response includes "character_uuids" array with a UUID for each tracked person

Tips

Video template vs multi-person template

If character_uuids is empty, it’s a video template — use with character_id. If character_uuids has entries, the template has multiple tracked persons.

Reusing imported scenes

Once imported, scenes are saved to your account and reusable across renders.

Get Started

Guides

Advanced

Reference

Import Templates from Viggle

Finding template IDs

Importing via the API

Tips

​Finding template IDs

​Importing via the API

​Tips

Finding template IDs

Importing via the API

Tips