latestSwagger 2.02026-08-19218237253.7 KB

3af866d68651

3D Models

Apply a curated animation preset to an already-rigged 3D model (retargeting). Pass the rigged GLB in `model` (URL or base64) and a `preset_id` from the animation presets list (see the spritesheet animation-presets endpoint) — only presets that expose a `clip_url` can be applied to a 3D model. The model must have a humanoid-template rig (rig it with rig_type humanoid_template or humanoid_template_hands). Synchronous: returns one retargeted animation — a standalone animation-only GLB in `glb_url` plus an mp4 `preview_url` — in the same `animations` envelope as the animate endpoint. crop_loop trims the clip to its seamlessly-looping span (omit to follow the preset's own loop flag); in_place removes net travel so the character moves on the spot, as game-engine locomotion expects (omit to follow crop_loop). Credits are charged only on success. Requires an API key (user scope).

post/assets/3d-model/animate-preset

Request body

modelstring required

URL or base64-encoded already-rigged GLB (rig it with a humanoid_template rig_type first).

preset_idstring required

id of an animation preset from the presets list. Only presets that expose a clip_url can be applied to a 3D model.

crop_loopboolean

Trim the animation to the span that loops seamlessly. Omit to follow the preset's own loop flag. Ignored when no clean loop exists.

in_placeboolean

Remove the animation's net travel so the character moves on the spot (engine-driven locomotion). Omit to follow crop_loop.

request_idstring

Optional client-provided id to retrieve the result later.

Response

Success