Auto Rig — Tripo Developers

http

Base URL: https://openapi.tripo3d.ai/v3

Endpoint: POST /animations/rig

Automatically add a skeleton rig to a 3D model. Run rig-check first to verify compatibility.

Note

This endpoint requires an API Key. Include it in the Authorization header as Bearer {api_key}.
This is an asynchronous API. After submitting the request, use the Task Query API to poll for results, or configure a Webhook to receive automatic notifications when the task completes.

Request Parameters

Request Body

inputstringRequired

Model source. Accepts task_id or file_token. Accepts the following input types:

Choose exactly one of the following — do not pass multiple types simultaneously.

task_id — The task ID returned by a previous 3D generation task (text_to_model, image_to_model, or multiview_to_model). The system automatically uses the 3D model output from that task.
Example: task_abc123
file_token — Upload a 3D model file via the File Upload API first, then pass the returned token.
Example: file_abc123
URL — A publicly accessible direct link to a 3D model file.
Example: https://example.com/model.glb

Notes

Supported formats: GLB, FBX, OBJ, STL
Max file size: 150 MB

modelstringdefault: v1.0-20240301

Rigging model version.

v1.0-20240301 — biped (humanoid) only. Supports 90+ animation presets.
v2.5-20260210 — non-humanoid creatures (quadruped, hexapod, octopod, serpentine, aquatic, avian). Bipeds are also supported but not recommended; use v3.0 for humanoids.
v3.0-20260909 — recommended for humanoid characters: faster, higher-quality humanoid rigging; other rig types keep v2.5 quality and speed. Supports rig_type others and the actorcore / unity / unreal / vrm skeleton conventions, and uses the same animation presets as v2.5. The default is unchanged; v3.0 must be requested explicitly.

rig_typestringdefault: biped

Rig type. Recommend calling rig-check first.

biped — humanoid, two legs.
quadruped — four-legged animal.
hexapod — six-legged creature.
octopod — eight-legged creature.
avian — bird / winged.
serpentine — snake-like.
aquatic — fish / aquatic.
others — skeletons that match none of the named topologies.

specstringdefault: tripo

Rigging specification. Only takes effect when rig_type is biped.

tripo — Tripo native bone naming.
mixamo — Mixamo-compatible bone naming.
actorcore — ActorCore humanoid bone naming.
unity — Unity Humanoid bone naming.
unreal — Unreal Mannequin bone naming.
vrm — VRM 1.0 humanoid bone naming.

out_formatstringdefault: glb

Output format.

glb — binary glTF, web-ready.
fbx — FBX for DCC tools and game engines.

Examples

Auto rig

{
  "input": "task_abc123",
  "model": "v3.0-20260909",
  "rig_type": "biped",
  "spec": "mixamo",
  "out_format": "glb"}

v3.0 with VRM skeleton

{
  "input": "task_abc123",
  "model": "v3.0-20260909",
  "rig_type": "biped",
  "spec": "vrm"}

Create task

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}

Task result

{
  "code": 0,
  "data": {
    "task_id": "task_def456",
    "status": "success",
    "output": {
      "model_url": "https://cdn.tripo3d.ai/output/rigged.glb"},
    "credits_consumed": 25.00
  }
}

Auto Rigging

curl --request POST \
  --url https://openapi.tripo3d.ai/v3/animations/rig \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "input": "task_abc123",
  "model": "v3.0-20260909",
  "rig_type": "biped",
  "spec": "mixamo",
  "out_format": "glb"}'

200Response

{
  "code": 0,
  "data": {
    "task_id": "task_abc123"}
}