Introducción
Tripo Animate recibe un personaje 3D estático y lo devuelve en movimiento. Añade el esqueleto y aplica hasta cinco movimientos de la biblioteca predefinida de Tripo en una sola solicitud. Así, un modelo creado a partir de una imagen puede caminar, correr o blandir una espada sin crear el esqueleto a mano. Cada movimiento se guarda como un clip con nombre dentro de un único GLB o FBX.
Funciones y aspectos destacados
Dieciséis movimientos para distintos cuerpos
Para humanoides hay idle, walk, run, dive, climb, jump, slash, shoot, hurt, fall y turn. Otras estructuras corporales tienen sus propios ciclos: quadruped:walk, hexapod:walk, octopod:walk, serpentine:march y aquatic:march.
Alterna entre clips
Nuestra solicitud con jump y slash produjo un GLB de 3.0 MB con dos clips llamados jump (2.2 segundos) y slash (6.6 segundos). Un visor web o motor de juegos los muestra por nombre y reproduce el que necesite la escena.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
mesh_url | Sí | Personaje que quieres animar: GLB, FBX binario, OBJ o STL, de hasta 90 MB. No necesita esqueleto; se añade durante la misma ejecución. mínimo 1 caracteres |
animations | Sí | De una a cinco filas, cada una con un movimiento predefinido como walk, run, jump o slash. Cada fila genera un clip separado en el archivo y añade costo. mínimo 1 elementos · máximo 5 elementos |
rig_type | No | Tipo de esqueleto, auto por defecto. Elige quadruped, hexapod, octopod, serpentine o aquatic al usar sus ciclos de marcha correspondientes. |
bone_naming | No | Nombres de huesos para esqueletos biped: tripo (predeterminado), mixamo, actorcore, unity, unreal o vrm. No cambia el precio. |
output_format | No | glb (predeterminado) o fbx. Ambos incluyen el esqueleto y todos los clips solicitados. |
in_place | No | Desactivado por defecto. Valor predeterminado: |
Precios
$0.504 / modelo animado
Un cargo fijo por entrega más un importe fijo por cada movimiento de animations: cinco movimientos cuestan más que uno. El tipo de esqueleto, los nombres de huesos, in_place y el formato de salida no cambian el precio. Las ejecuciones fallidas no se cobran.
Casos de uso
Lleva un héroe generado a un juego de navegador
Solicita idle, walk y jump con in_place activado, carga el GLB en un motor web y deja que el controlador del personaje gestione el desplazamiento mientras los clips animan el cuerpo.
Prepara la animación de una toma
Usa walk o run como movimiento inicial, renderízalo en una vista previa sencilla en gris y envíala a un modelo de video que transforme escenas 3D preliminares en tomas con acabado final.
Guía de prompts y consejos prácticos
Elige movimientos compatibles con el cuerpo
No hay un prompt de texto: las filas de animations determinan el movimiento. Usa los ajustes humanoides para personajes de dos piernas. Para animales y criaturas, combina rig_type con el ciclo de marcha correspondiente.
Decide pronto cómo se desplazará el personaje
Con in_place desactivado, walk y run avanzan por la escena, lo que resulta adecuado para cinemáticas y vistas previas. Actívalo cuando el código del juego se encargue de mover al personaje. Cada movimiento adicional aumenta el precio, así que solicita solo los clips que vayas a usar.
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/animate",
"input": {
"animations": [
{
"name": "idle"
}
],
"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.





