Introducción
Tripo Convert cambia el formato de un modelo 3D y puede ajustarlo durante la conversión. Es el último paso tras generar, crear el esqueleto o animar: el mismo personaje puede salir como GLB para un juego de navegador, FBX para Blender o un motor de juegos, o STL para una impresora. Por defecto, el esqueleto y los clips de animación acompañan al modelo.
Funciones y aspectos destacados
Conserva esqueletos y clips al convertir
Exportamos un astronauta animado a FBX y convertimos ese FBX de nuevo a GLB. El resultado conservaba 78 articulaciones, tres mapas de textura y el clip walk, que se reprodujo de inmediato en un visor web.
Ajustes opcionales
face_limit reduce la cantidad de polígonos; quad_mesh reconstruye la superficie con cuadriláteros para programas de modelado; texture_size y texture_format reducen o cambian los mapas de imagen; y pivot_to_bottom, flatten_bottom y scale_factor preparan el modelo para colocarlo o imprimirlo. Cualquiera de estos ajustes aplica la tarifa superior.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
mesh_url | Sí | Modelo que quieres convertir: GLB, FBX binario, OBJ o STL, de hasta 90 MB. Admite archivos con esqueleto y animación. mínimo 1 caracteres |
output_format | Sí | Obligatorio. glb para navegadores y juegos web, fbx para programas de animación y motores, stl para impresión 3D (solo geometría). |
quad_mesh | No | Desactivado por defecto. Al activarlo, reconstruye la malla con polígonos de cuatro lados, unas 10,000 caras salvo que definas |
face_limit | No | Máximo opcional de caras, de 48 a 2,000,000. Déjalo vacío para conservar la cantidad original. |
texture_size | No | Tamaño de la textura difusa en píxeles, de 128 a 8192; 4096 por defecto. Cualquier otro valor aplica la tarifa superior. |
texture_format | No | jpeg (predeterminado), png o webp para las texturas exportadas. png y webp aplican la tarifa superior. |
pivot_to_bottom | No | Desactivado por defecto. Al activarlo, mueve el pivote al centro de la base para que el modelo se apoye en el suelo al colocarlo. Valor predeterminado: |
scale_factor | No | Escala uniforme de exportación, 1 por defecto. Cualquier otro valor aplica la tarifa superior. |
flatten_bottom | No | Desactivado por defecto. Al activarlo, aplana la parte inferior, lo que resulta útil antes de imprimir en 3D. Valor predeterminado: |
forward_axis | No | Eje hacia el que mira el modelo en el archivo exportado: +x (predeterminado), -x, +y o -y. No cambia el precio. |
fbx_preset | No | Ajuste de compatibilidad para exportar FBX: blender (predeterminado), 3dsmax, mixamo o |
bake_textures | No | Activado por defecto: integra los materiales avanzados en las texturas base. No cambia el precio. Valor predeterminado: |
keep_animation | No | Activado por defecto: escribe el esqueleto y los clips de animación en el nuevo archivo. Desactívalo para obtener una malla estática. Valor predeterminado: |
in_place | No | Desactivado por defecto. Al activarlo, elimina el desplazamiento hacia adelante de los clips de animación durante la exportación. Valor predeterminado: |
Precios
$0.072 / conversión
Tarifa básica para un cambio de formato simple. Se aplica una tarifa superior al usar cualquier opción de modificación: quad_mesh, face_limit, flatten_bottom, pivot_to_bottom, texture_size distinto de 4096, texture_format distinto de jpeg o scale_factor distinto de 1. Las ejecuciones fallidas no se cobran.
Casos de uso
Convierte FBX en GLB para la web
Los programas de animación y Rig o Animate configurados en FBX generan archivos que los navegadores no pueden abrir. Conviértelos a GLB y cárgalos en three.js, Babylon.js o un motor de juegos web.
Imprime una pose
Dale una pose o anima un personaje, expórtalo como STL con flatten_bottom activado y envía el archivo a un programa de laminado. STL solo contiene geometría, por lo que se eliminan el color y el movimiento.
Guía de prompts y consejos prácticos
Elige el formato según el destino
No hay prompt. Configura output_format en glb, fbx o stl. quad_mesh siempre produce FBX, por lo que una solicitud con cuadriláteros necesita output_format en fbx.
Mantén los ajustes básicos si no necesitas más
Una conversión que solo use formato, forward_axis, fbx_preset, bake_textures, keep_animation e in_place conserva la tarifa básica. Deja texture_size en 4096, texture_format en jpeg y scale_factor en 1, salvo que necesites cambiarlos.
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/convert",
"input": {
"fbx_preset": "blender",
"flatten_bottom": false,
"forward_axis": "+x",
"mesh_url": "https://example.com/reference.png",
"output_format": "glb",
"pivot_to_bottom": false,
"quad_mesh": false
}
}'
# 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.





