Verificación de rigabilidad

POST /v3/animations/rig-check

Compruebe si un modelo admite rigging y devuelva el tipo de rigging recomendado.

Solicitar parámetros

Encabezados de solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
Content-Type	cadena	si	—	`application/json`
Authorization	cadena	si	—	`Bearer {api_key}`

Cuerpo de solicitud

Parámetro	Tipo	Requerido	Predeterminado	Descripción
input	cadena	si	—	Fuente del modelo. Acepta un task_id que comienza con `task_`, un file_token que comienza con `file_` o un URL de acceso público a un archivo de modelo. Formatos admitidos: GLB, FBX, OBJ, STL (máximo 150 MB).

Ejemplos de solicitudes

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);

Respuesta

Respuesta exitosa

JSON

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

salida después de completar la tarea

JSON

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

Campos de respuesta

Parámetro	Tipo	Descripción
code	entero	Código de estado. `0` indica éxito
data.task_id	cadena	Identificador de tarea único utilizado para sondear el progreso y el resultado de la verificación de rigabilidad

campos de salida

Parámetro	Tipo	Descripción
riggable	booleano	Si el modelo es manipulable
rig_type	cadena	Tipo de rigging recomendado. Valores posibles: `biped` (bípedo), `quadruped` (cuadrúpedo), `hexapod` (hexápodo), `octopod` (octópodo), `avian` (aviar), `serpentine` (serpentina), `aquatic` (acuático)

Códigos de error

Código de estado HTTP	Código de error	Descripción	Recomendación
429	2000	Límite de generación excedido	Reduzca la tasa de solicitudes y vuelva a intentarlo más tarde
400	2002	Parámetro de solicitud no admitido	Verifique los nombres de los parámetros del cuerpo de la solicitud y los rangos de valores
400	2006	Tipo de tarea de fuente de entrada no válida	Confirmar que el task_id corresponde a una tarea de modelo 3D
400	2007	El estado de la tarea de origen no es exitoso	Espere hasta que se complete la tarea de origen antes de comenzar la verificación.
403	2010	Créditos insuficientes	Recarga créditos y vuelve a intentarlo