specstring
Bone naming for biped rigs. actorcore, unity, unreal and vrm need rig model v3.0-20260909.
Default: "tripo"
Possible values: "tripo", "mixamo", "actorcore", "unity", "unreal", "vrm"
tripo3d/tripo/animateTripo Animate rigs a 3D character or creature and applies preset animations to it in one call (Tripo Rig + Animation Retarget).
Try the model
Your output will appear here
Complete the inputs, then click Run.
Tripo Animate rigs a 3D character or creature and applies preset animations to it in one call (Tripo Rig + Animation Retarget).
| Field | Type | Default | Notes |
|---|---|---|---|
model_url | string, required | — | URL of the 3D model (GLB, FBX, OBJ or STL, up to 150 MB). |
animation | string | — | One preset, e.g. preset:walk. Rig v3.0 biped: preset:idle, walk, run, dive, climb, jump, slash, shoot, hurt, fall, turn. Non-biped: preset:quadruped:walk, preset:hexapod:walk, preset:octopod:walk, preset:serpentine:march, preset:aquatic:march. Rig v1.0: preset:biped:<name>. Use animation or animations. |
animations | array | — | 1 to 5 presets in one file (same names as animation). Each animation is billed. |
model_version | v3.0-20260909 / v2.5-20260210 / v1.0-20240301 | v3.0-20260909 | v3.0-20260909 is recommended for humanoids and supports others; v2.5-20260210 for non-humanoids; v1.0-20240301 biped only (90+ presets). |
rig_type | biped / quadruped / hexapod / octopod / avian / serpentine / aquatic / others | biped | Skeleton type. Use Tripo Rig Check to find it. |
spec | tripo / mixamo / actorcore / unity / unreal / vrm | tripo | Bone naming for biped rigs. actorcore, unity, unreal and vrm need rig model v3.0-20260909. |
out_format | glb / fbx | glb | Format of the rigged and the animated model. |
export_with_geometry | boolean | true | Include the mesh in the animated file; false exports the skeleton animation only. |
animate_in_place | boolean | false | Remove root motion so the character stays in place. |
url: Animated model.rigged: Rigged model without animation.thumbnail: Preview render.$0.25 for rigging plus $0.10 per animation ($0.35 with one animation). Failed runs are not charged.
Start building
Submit this model through the SandBase Unified Run API.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "tripo3d/tripo/animate",
"spec": "tripo",
"rig_type": "biped",
"model_url": "https://static.sandbase.ai/examples/tripo3d/tripo/shared/character.glb",
"out_format": "glb",
"model_version": "v3.0-20260909",
"animate_in_place": false,
"export_with_geometry": true
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
specstringBone naming for biped rigs. actorcore, unity, unreal and vrm need rig model v3.0-20260909.
Default: "tripo"
Possible values: "tripo", "mixamo", "actorcore", "unity", "unreal", "vrm"
rig_typestringSkeleton type. Use Tripo Rig Check to find it.
Default: "biped"
Possible values: "biped", "quadruped", "hexapod", "octopod", "avian", "serpentine", "aquatic", "others"
animationstringOne preset, e.g. preset:walk. Rig v3.0 biped: preset:idle, walk, run, dive, climb, jump, slash, shoot, hurt, fall, turn. Non-biped: preset:quadruped:walk, preset:hexapod:walk, preset:octopod:walk, preset:serpentine:march, preset:aquatic:march. Rig v1.0: preset:biped:<name>. Use animation or animations.
model_urlstringrequiredURL of the 3D model (GLB, FBX, OBJ or STL, up to 150 MB).
animationsarray1 to 5 presets in one file (same names as animation). Each animation is billed.
out_formatstringFormat of the rigged and the animated model.
Default: "glb"
Possible values: "glb", "fbx"
model_versionstringv3.0-20260909 is recommended for humanoids and supports others; v2.5-20260210 for non-humanoids; v1.0-20240301 biped only (90+ presets).
Default: "v3.0-20260909"
Possible values: "v3.0-20260909", "v2.5-20260210", "v1.0-20240301"
animate_in_placebooleanRemove root motion so the character stays in place.
Default: false
export_with_geometrybooleanInclude the mesh in the animated file; false exports the skeleton animation only.
Default: true
{
"model": "tripo3d/tripo/animate",
"spec": "tripo",
"rig_type": "biped",
"model_url": "https://static.sandbase.ai/examples/tripo3d/tripo/shared/character.glb",
"out_format": "glb",
"model_version": "v3.0-20260909",
"animate_in_place": false,
"export_with_geometry": true
}A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
No example output has been published yet. Use Playground → Result → JSON after a completed run to inspect your response.