Rigging automatique

POST /v3/animations/rig

Ajoutez automatiquement une plate-forme squelette à un modèle 3D.

Paramètres de la demande

En-têtes de demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
Content-Type	chaîne	Oui	—	`application/json`
Authorization	chaîne	Oui	—	`Bearer {api_key}`

Corps de la demande

Paramètre	Tapez	Obligatoire	Par défaut	Descriptif
input	chaîne	Oui	—	Source du modèle. Accepte un task_id commençant par `task_` ou un file_token commençant par `file_`
model	chaîne	Non	`v1.0-20240301`	Version du modèle de rigging automatique. Valeurs possibles : `v1.0-20240301` (bipède uniquement), `v2.5-20260210` (non humanoïdes ; bipèdes pris en charge mais déconseillés), `v3.0-20260909` (recommandé pour les humanoïdes ; à définir explicitement ; mêmes préréglages d’animation que v2.5)
rig_type	chaîne	Non	`biped`	Type de plate-forme. Nous vous recommandons d’appeler d’abord `rig-check` pour obtenir la valeur recommandée. Valeurs possibles : `biped`, `quadruped`, `hexapod`, `octopod`, `avian`, `serpentine`, `aquatic`, `others`
spec	chaîne	Non	`tripo`	Spécification du rigging. Ne s’applique que si `rig_type` vaut `biped`. Valeurs possibles : `tripo`, `mixamo`, `actorcore`, `unity`, `unreal`, `vrm`
out_format	chaîne	Non	`glb`	Format de sortie. Valeurs possibles : `glb`, `fbx`

Exemples de demande

curl -X POST https://openapi.tripo3d.ai/v3/animations/rig \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123",
    "model": "v3.0-20260909",
    "rig_type": "biped",
    "spec": "mixamo",
    "out_format": "glb"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/animations/rig"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123",
    "model": "v3.0-20260909",
    "rig_type": "biped",
    "spec": "mixamo",
    "out_format": "glb"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const url = "https://openapi.tripo3d.ai/v3/animations/rig";

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123",
    model: "v3.0-20260909",
    rig_type: "biped",
    spec: "mixamo",
    out_format: "glb"
  })
});

const data = await response.json();
console.log(data);

Réponse

Réponse réussie

JSON

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

Champs de réponse

Paramètre	Tapez	Descriptif
code	entier	Code d’état. `0` indique le succès
data.task_id	chaîne	Identifiant de tâche unique utilisé pour interroger la progression et le résultat du rigging automatique

Codes d’erreur

Code d’état HTTP	Code d’erreur	Descriptif	Recommandation
429	2000	Limite de génération dépassée	Réduisez le taux de demandes et réessayez plus tard
400	2002	Paramètre de requête non pris en charge	Vérifier les noms des paramètres du corps de la requête et les plages de valeurs
400	2006	Type de tâche source d’entrée non valide	Confirmer que le task_id correspond à une tâche de modèle 3D
400	2007	L’état de la tâche source n’a pas réussi	Attendez que la tâche source soit terminée avant de démarrer le rigging automatique
403	2010	Crédits insuffisants	Recharger les crédits et réessayer