Post-process

Auto-rig & Animate

POST/v1/assets/{id}/animate

Rig a humanoid automatically and, optionally, retarget a walk/run/idle clip onto it — no manual weights.

Parameters

Parameter	Description
engine string	`tripo-rig-animate` / `meshy-rig-animate` apply a clip; `tripo-rig` / `meshy-rig` rig only.
preset string	An animation id from `GET /v1/animations`. Only used by the `-rig-animate` engines.

Request

request

curl -X POST https://api.picoberry.ai/v1/assets/019…/animate \
  -H "Authorization: Bearer pb_live_xxx" -H "Content-Type: application/json" \
  -d '{"engine":"tripo-rig-animate","preset":"walk"}'

requests.post(f"{BASE}/v1/assets/{id}/animate", headers=headers,
    json={"engine": "tripo-rig-animate", "preset": "walk"})

await fetch(`${BASE}/v1/assets/${id}/animate`, { method: "POST",
  headers: { ...headers, "Content-Type": "application/json" },
  body: JSON.stringify({ engine: "tripo-rig-animate", preset: "walk" }) });

Presets are engine-specific A Tripo preset will not run on a Meshy engine. Pick presets from the same engine you animate with.