Vérification de la gréabilité

POST /v3/animations/rig-check

Vérifiez si un modèle peut être riggé et renvoyez le type de rigging recommandé.

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_`, un file_token commençant par `file_` ou un URL accessible publiquement vers un fichier de modèle. Formats pris en charge : GLB, FBX, OBJ, STL (max 150 MB).

Exemples de demande

curl -X POST https://openapi.tripo3d.ai/v3/animations/rig-check \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {api_key}" \
  -d '{
    "input": "task_abc123"
  }'

import requests

url = "https://openapi.tripo3d.ai/v3/animations/rig-check"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
}
payload = {
    "input": "task_abc123"
}

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

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

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {api_key}"
  },
  body: JSON.stringify({
    input: "task_abc123"
  })
});

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

Réponse

Réponse réussie

JSON

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

sortie après l’achèvement de la tâche

JSON

{
  "riggable": true,
  "rig_type": "biped"
}

Champs de réponse

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

Champs de sortie

Paramètre	Tapez	Descriptif
riggable	booléen	Si le modèle est gréable
rig_type	chaîne	Type de plate-forme recommandé. Valeurs possibles : `biped` (bipède), `quadruped` (quadrupède), `hexapod` (hexapode), `octopod` (octopode), `avian` (aviaire), `serpentine` (serpentin), `aquatic` (aquatique)

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 la fin de la tâche source avant de lancer la vérification
403	2010	Crédits insuffisants	Recharger les crédits et réessayer