Skip to content

List animations

GET/v1/animations

Returns the shared animation catalog: 260 clips released under CC0, hosted on our CDN. Listing and downloading clips is free. Applying one through the API is a server-side retarget and is billed per clip — see pricing.

Query parameters

ParameterTypeDescription
querystringCase-insensitive substring match on the clip name
groupstringFilter by category (see below)
limitintegerMax clips to return. Default 200, max 500

Groups: locomotion, traversal, combat, interaction, emote, zombie, other.

Response

200 OK

json
{
  "object": "list",
  "total": 41,
  "license": "CC0-1.0",
  "animations": [
    {
      "id": "Walk",
      "name": "Walk",
      "group": "locomotion",
      "loop": true,
      "root_motion": false,
      "url": "https://cdn.cinevva.com/rt/clips/1/walk.glb"
    }
  ]
}
FieldDescription
idStable identifier. Use this to reference a clip, not name
loopWhether the clip is built to cycle seamlessly
root_motionWhether the clip translates the root, or animates in place
urlDirect CDN link to the clip as a GLB

Example

bash
# Every looping locomotion clip
curl "https://api.cinevva.com/v1/animations?group=locomotion" \
  -H "Authorization: Bearer $CINEVVA_API_KEY"

# Search by name
curl "https://api.cinevva.com/v1/animations?query=jump" \
  -H "Authorization: Bearer $CINEVVA_API_KEY"

Using clips

Clips are humanoid, authored on a standard skeleton. Because rigs come back with Mixamo-compatible bone naming, most engines will retarget a clip onto a rigged character with no manual bone mapping, and doing it that way is free. See the animations guide for how, in Unity, Unreal, Godot, and three.js, and for what to do with non-humanoid rigs, which these clips will not fit.

To have us do it instead, pass the clip's url as animation_url on POST /v1/rigs. That runs on our hardware and is billed per clip.

Licensing

The catalog is CC0-1.0 (public domain dedication), sourced from Quaternius. You can use, modify, and redistribute the clips commercially with no attribution required. This is deliberate: it means clips can ship inside your game without a license audit.