Introducción
Tripo Auto Rig dota de esqueleto a un modelo 3D estático. Admite personas, animales y criaturas fantásticas, conserva la malla y las texturas, y devuelve un GLB o FBX listo para posar o animar en tus herramientas. Úsalo si solo necesitas los huesos; si también quieres movimiento en la misma solicitud, elige el endpoint Animate de Tripo 3D Tools.
Funciones y aspectos destacados
Nueve tipos de esqueleto
rig_type admite biped, quadruped, hexapod, octopod, avian, serpentine, aquatic y others, además de auto, que elige según la forma. En nuestro astronauta de juguete erguido, auto eligió un esqueleto humanoide de 78 articulaciones, con dedos individuales.
Nombres de huesos que tu motor reconoce
Para esqueletos biped, bone_naming permite alternar entre los nombres de Tripo y las convenciones de Mixamo, ActorCore, Unity, Unreal y VRM. Así, las herramientas de transferencia de animaciones y los sistemas de avatares reconocen los huesos sin renombrarlos a mano.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
mesh_url | Sí | Modelo al que se añadirá el esqueleto: GLB, FBX binario, OBJ o STL, de hasta 90 MB. El enlace directo debe terminar en la extensión correspondiente. mínimo 1 caracteres |
rig_type | No | Tipo de esqueleto. auto (predeterminado) decide según la forma; también puedes elegir biped, quadruped, hexapod, octopod, avian, serpentine, aquatic u others. |
bone_naming | No | Nombres de huesos para esqueletos biped: tripo (predeterminado), mixamo, actorcore, unity, unreal o vrm. Se ignora en los demás tipos de esqueleto. |
output_format | No | glb (predeterminado) para navegadores y motores web, fbx para programas de animación de escritorio. No cambia el precio. |
Precios
$0.36 / esqueleto
Un cargo fijo por entrega exitosa, independientemente del tipo de esqueleto, los nombres de huesos o el formato de salida. Las ejecuciones fallidas, incluidos los archivos no compatibles, no se cobran.
Casos de uso
Dale una pose a un personaje generado
Añade un esqueleto a un modelo creado con una herramienta de imagen a 3D y dale una pose en Blender o un visor web para imágenes fijas, miniaturas o una impresión 3D en una postura dinámica.
Prepara avatares y personajes no jugables
Usa nombres de huesos de Unity, Unreal o VRM para integrar el personaje en un conjunto de animaciones o un proceso de creación de avatares existente.
Guía de prompts y consejos prácticos
Proporciona una silueta bien definida
No se utiliza un prompt de texto. El esqueleto se crea con más precisión si el modelo está erguido, con los brazos algo separados del cuerpo y las piernas abiertas. Las extremidades fusionadas o los brazos cruzados dificultan colocar las articulaciones.
Elige el archivo para el siguiente paso
Mantén output_format en glb para usarlo en la web o con el endpoint Convert; elige fbx para programas de escritorio. Sube GLB, FBX binario, OBJ o STL de hasta 90 MB; primero exporta los archivos JSON .gltf a .glb.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/tools/rig",
"input": {
"bone_naming": "tripo",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"rig_type": "auto"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.





