# Tripo3D Tripo Animate API

> Tripo Animate rigs a 3D character or creature and applies preset animations to it in one call (Tripo Rig + Animation Retarget).

Source: https://www.sandbase.ai/models/tripo3d/tripo/animate
API reference: https://www.sandbase.ai/models/tripo3d/tripo/animate#api

## Facts

- Provider: Tripo3D
- Type: Image model
- Model ID: `tripo3d/tripo/animate`
- Price: From $0.35 per run
- Capabilities: 3d to 3d
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "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
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call Tripo3D Tripo Animate through SandBase?

Create a SandBase API key, then send requests with the model ID "tripo3d/tripo/animate" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate Tripo3D account?

No. One SandBase API key and balance gives you access to Tripo3D Tripo Animate and the other models in the catalog; you do not need to sign up with Tripo3D separately.

## README

### Tripo Animate
Tripo Animate rigs a 3D character or creature and applies preset animations to it in one call (Tripo Rig + Animation Retarget).
#### Fields
| 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. |
#### Output
- `url`: Animated model.
- `rigged`: Rigged model without animation.
- `thumbnail`: Preview render.
#### Billing
$0.25 for rigging plus $0.10 per animation ($0.35 with one animation).
Failed runs are not charged.
