Introducción
Tripo H3.1 es el modelo de imagen a 3D que Tripo AI presentó en marzo de 2026 para assets de producción, con geometría más nítida, más fidelidad a la imagen de entrada y texturas de mejor calidad que sus modelos H anteriores. Envías una imagen (image_url) y recibes un archivo glTF binario (.glb). A diferencia de los convertidores de un solo ajuste, cada etapa del proceso está a tu alcance: si la malla lleva textura, mapas PBR, texturas HD, geometría detallada, topología de quads, número de caras objetivo, escala real, orientación final y dos seeds separados. No hay prompt.
Funciones y aspectos destacados
Una forma que sigue a la imagen
En nuestra prueba con una bota, el modelo respetó las proporciones de la foto y colocó la presilla del talón, los ganchos de las agujetas y la suela en el lado correcto, aunque la foto solo mostraba el frente. El resultado con textura llevó a la malla el cuero gastado, las agujetas rojas y las costuras.
Texturas que se activan y se mejoran
Las texturas vienen activadas por defecto y en un juego PBR completo. Nuestro archivo con ajustes predeterminados traía un color base, un mapa de metal-rugosidad y un normal map de 2048 píxeles en un solo material. texture_quality: detailed pide texturas de mayor resolución, extreme pide 8K y fast mantiene el tamaño estándar y termina antes; con generate_texture y generate_pbr desactivados vuelve una malla lisa al precio más bajo.
Topología y tamaño bajo tu control
face_limit limita el número de caras entre 1.000 y 2.000.000, quad_mesh cambia a polígonos de cuatro lados para editar en un programa de modelado y geometry_quality: detailed dedica más al relieve fino. auto_size escala la malla a dimensiones reales y model_orientation: align_image la gira para que coincida con la imagen.
Mallas de bajo polígono y partes separadas
low_poly reemplaza la superficie densa, de aspecto escaneado, por una topología limpia de bajo polígono para accesorios sencillos: nuestra bota con face_limit: 5000 volvió en unos tres minutos como un GLB de 0,38 MB con 7.675 triángulos. generate_parts en cambio divide el sujeto en partes con nombre dentro de un solo GLB; nuestro astronauta de juguete volvió en 78 segundos como 18 partes sin textura, con 47.304 triángulos en total.
Lo que medimos
Con los ajustes predeterminados, una vista frontal de 1024×1024 de una bota de cuero volvió en 167 segundos como un GLB de 45,8 MB con 1.471.382 triángulos y tres texturas. Esa densidad es justo la razón para fijar face_limit en todo lo que se muestre en un navegador.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La imagen que se va a modelar: JPEG, PNG o WebP de hasta 10 MB. mínimo 1 caracteres |
generate_texture | No | Activado por defecto. Pinta una textura sobre la malla. Valor predeterminado: |
generate_pbr | No | Activado por defecto. Añade mapas de material PBR (metal-rugosidad y normal) al color base y activa el texturizado aunque |
texture_quality | No | standard (predeterminado), detailed, extreme o fast. detailed da texturas de mayor resolución y extreme texturas de 8K; cada una suma al precio. |
texture_version | No | v3.0-20250812 (predeterminado) o la más reciente v3.5-20260815. |
remove_lighting | No | Activado por defecto. Quita los brillos y sombras horneados en la imagen antes de texturizar, para que el modelo reaccione a las luces de tu propia escena. Valor predeterminado: |
geometry_quality | No | standard (predeterminado) o detailed. detailed construye un relieve más fino y es el recargo más caro. |
quad_mesh | No | Desactivado por defecto. Valor predeterminado: |
low_poly | No | Desactivado por defecto. Activado construye una malla ligera con topología limpia, de estilo modelado a mano, ideal para accesorios sencillos; mantén |
generate_parts | No | Desactivado por defecto. Activado devuelve el modelo como partes separadas con nombre en un solo GLB (18 partes para nuestro astronauta de juguete). Valor predeterminado: |
face_limit | No | Número de caras objetivo opcional, de 1.000 a 2.000.000. |
image_autofix | No | Desactivado por defecto. Activado repara una imagen borrosa, con ruido o de baja resolución antes de modelar, lo que tarda más. Valor predeterminado: |
model_orientation | No | default mantiene la orientación estándar del modelo; |
texture_alignment | No |
|
auto_size | No | Desactivado por defecto. Activado escala la malla a dimensiones reales estimadas, útil para RA e impresión. Valor predeterminado: |
uv_unwrap | No | Activado por defecto. Valor predeterminado: |
seed | No | Seed opcional de la etapa de geometría. Mantenlo fijo para reproducir la misma forma. |
texture_seed | No | Seed opcional de la etapa de textura. Mantén seed fijo y cambia este para probar texturas nuevas sobre la misma forma. |
Precios
$0.432 / modelo
Cada solicitud se cobra una vez cuando se entrega el modelo: un precio base por la malla, más recargos fijos por texturas (generate_texture o generate_pbr), texturas detalladas u 8K, geometría detallada, topología de quads, topología de bajo polígono y partes separadas. Con generate_parts activado, los recargos de textura y de quads no se aplican, porque las partes son mallas de triángulos sin textura. El número de caras, la escala, la orientación, la alineación, la versión de textura, la eliminación de iluminación, el desenvolvido UV, la limpieza de la imagen y los seeds no cambian el precio, y una solicitud fallida no se cobra.
Casos de uso
Assets para juegos, RA y escenas en tiempo real
Ajusta face_limit al presupuesto de tu escena, activa quad_mesh si el asset se va a editar y deja el PBR encendido para que el modelo reaccione a la iluminación. Una solicitud por accesorio mantiene coherente el conjunto y barato de regenerar.
Visualización de producto e impresión
Para un visor de producto deja las texturas activadas y usa texture_quality: detailed cuando las etiquetas o las costuras deban leerse. Para impresión 3D o escultura, desactiva los dos interruptores de textura y activa auto_size para que la malla llegue a una escala realista.
Guía de prompts y consejos prácticos
Empieza con una imagen limpia
Un solo sujeto, completo en el encuadre, sobre fondo liso. Una vista de tres cuartos le dice al modelo más sobre la profundidad que una vista frontal. Acepta archivos JPEG, PNG o WebP que no pasen de 10 MB.
Activa solo lo que necesitas
Cada opción de pago se suma al precio: texturas, texturas HD u 8K, geometría detallada, topología de quads, topología de bajo polígono y partes separadas. Haz una primera pasada con los ajustes predeterminados y un face_limit, y luego mejora solo la etapa que se quede corta.
Itera con los dos seeds
seed fija la geometría y texture_seed la textura. Mantén seed y cambia texture_seed para probar superficies nuevas sobre la misma forma, o mantén texture_seed mientras exploras formas.
Revisa el lado oculto
Abre el GLB en un visor y dale una vuelta completa antes de usarlo. Si el lado que no se veía está mal, cambiar el ángulo de cámara de la imagen original ayuda más que cualquier ajuste.
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/h3.1/image-to-3d",
"input": {
"generate_parts": false,
"generate_pbr": true,
"generate_texture": true,
"geometry_quality": "standard",
"image_url": "https://example.com/reference.png",
"low_poly": 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.










