Reuse characters and motions - Viggle API

Create a Character or Motion once when you expect to use it in more than one Render. V1 keeps these as separate reusable resources. See the Character and Motion Quickstarts for complete, runnable versions of the two creation calls below.

Create a Character

curl -X POST "https://apis.viggle.ai/v1/characters" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "[email protected]" \
  -F "name=Presenter"

Create a Motion

curl -X POST "https://apis.viggle.ai/v1/motions" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "[email protected]" \
  -F "name=Dance loop"

Both operations return an asynchronous resource. Wait until each resource has status: "ready" before using it in a Render.

Render with reusable IDs

curl -X POST "https://apis.viggle.ai/v1/renders" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "character_id=char_123abc" \
  -F "motion_id=mot_456def"

Asset readiness

Characters and Motions expose a capabilities array. Use an asset in a Render only when its status is ready and capabilities includes video_render.

Use direct inputs for a one-time job. Use reusable assets when the same character or motion appears in multiple renders.