> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mint.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Animation

> Animate eligible 3D Models and Asset Pack characters and retrieve their clips.

Animation is a separate workflow for eligible humanoid 3D Models and Asset Pack items.

Each accepted animation request can create new output. If a response is lost, retry only with the same `Idempotency-Key` that you supplied on the first attempt.

## Choose animations

Use `GET /v1/animation-sets` for curated sets or `GET /v1/animation-options` to search individual actions.

## Animate a 3D Model

Call `POST /v1/models/{modelId}:animate` with either `animationSetId` or `motionPrompt`. When using a set, optionally choose `animationActionIds`. `heightMeters` controls character scale.

## Animate Asset Pack items

Call `POST /v1/asset-packs/{assetPackId}:animate`. Use `scope: "items"` with `itemIds` to target selected eligible characters; otherwise the request applies to all eligible items.

## Track and retrieve animation outputs

Poll the returned operation. Read the resulting animation resource, then use its `/artifacts` or `/artifact-manifest` route to retrieve clips and packaged files. Keep animation files with their source 3D Model or Asset Pack in your application's asset record.