Introducción
Tripo H3.1 Text to 3D transforma una descripción en un objeto 3D, normalmente un GLB con texturas. Primero crea una imagen de referencia y luego construye la malla. image_seed corresponde a esa primera imagen; geometría y texturas tienen sus propias semillas.
Funciones y aspectos destacados
Metal descrito con palabras
El casco de buceo envejecido tardó 141 segundos con los valores predeterminados: 46.9 MB, cerca de 1.49 millones de triángulos y tres mapas de 2048 píxeles. Se ven remaches, pátina verde y ventanilla redonda.
Piezas para seguir trabajando
El robot tardó 118 segundos: GLB de 1.48 MB con 17 nodos sin textura y 48,411 triángulos. generate_parts anula texturas y quads; fuera de ese modo, quad_mesh cambia la salida a FBX.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Para el objeto descrito: Descripción obligatoria de hasta 1,024 caracteres: objeto entero, forma, material, color, estilo y escala. mínimo 1 caracteres · máximo 1024 caracteres |
negative_prompt | No | Para el objeto descrito: Exclusiones breves de hasta 255 caracteres, por ejemplo base o pedestal. máximo 255 caracteres |
generate_texture | No | Para el objeto descrito: Activo por defecto; para quitar la textura de color también debes desactivar |
generate_pbr | No | Para el objeto descrito: Activo por defecto; los materiales PBR habilitan texturas aunque |
texture_quality | No | Para el objeto descrito: standard es el valor predeterminado; detailed y extreme (8K) agregan costo; fast usa v3.5 al precio de standard; sin texturas no se cobra calidad. |
texture_version | No | Para el objeto descrito: Elige v3.0-20250812 por defecto o v3.5-20260815; fast y la eliminación de iluminación usan v3.5. |
remove_lighting | No | Para el objeto descrito: Activo por defecto, solo funciona con v3.5; elimina la iluminación incorporada en la referencia. Valor predeterminado: |
geometry_quality | No | Para el objeto descrito: standard o detailed; detailed agrega detalle geométrico y su propio costo. |
quad_mesh | No | Para el objeto descrito: Produce topología de cuadriláteros en FBX en lugar de GLB; con |
low_poly | No | Para el objeto descrito: Procesamiento low-poly de aspecto artesanal con adicional propio; se recomienda |
generate_parts | No | Para el objeto descrito: Separa piezas triangulares sin textura; ignora las opciones de textura y quads y reemplaza esos adicionales por el de separación. Valor predeterminado: |
face_limit | No | Para el objeto descrito: Objetivo de 1,000 a 2,000,000 caras para el objeto descrito; con |
auto_size | No | Para el objeto descrito: Apagado por defecto; estima dimensiones reales y requiere salida con texturas. Valor predeterminado: |
uv_unwrap | No | Para el objeto descrito: Activo por defecto; apagar la exportación UV reduce tiempo y tamaño, pero elimina las coordenadas para texturizar después. Valor predeterminado: |
seed | No | Para el objeto descrito: Semilla geométrica para comparar un cambio por vez, sin garantía de repetición exacta. |
image_seed | No | Para el objeto descrito: Semilla de la imagen de referencia previa al 3D, para comparar sin prometer repetición exacta. |
texture_seed | No | Para el objeto descrito: Semilla de texturas para comparar superficies sin garantizar salidas idénticas. |
Precios
$0.288 / modelo
La entrada de texto tiene una base de malla menor que la entrada de imagen H3.1 y la misma estructura de adicionales para texturas, detailed o 8K, geometría detallada, quads y low-poly. generate_parts sustituye los adicionales de textura y quads por el de separación de piezas. Los intentos fallidos no se cobran.
Casos de uso
Explora un accesorio imaginado
Describe un casco, una tetera o un juguete sin necesitar una foto. Evalúa primero las proporciones, el color y el material.
Prepara piezas editables
Revisa las partes por separado en un editor y asigna tus propios materiales. Si vas a imprimir, comprueba la geometría y las dimensiones.
Guía de prompts y consejos prácticos
Empieza por la forma principal
Describe un objeto completo: forma, material, color, estilo y escala. prompt admite 1,024 caracteres y negative_prompt hasta 255 para exclusiones breves.
Las metáforas pueden simplificarse
Los elementos de zorro se lograron solo en parte: la tetera de esmalte naranja tiene una pequeña cabeza de zorro en el pico, con orejas puntiagudas, nariz y ojos, y salientes naranjas parecidos a orejas o colas en la parte posterior. No se lograron el cuerpo de zorro dormido y acurrucado ni la cola como asa; el asa es un arco alto convencional. La prueba tardó 91 segundos y entregó 59,722 triángulos en 3.38 MB.
Controla la entrega
face_limit admite de 1,000 a 2,000,000; con low_poly se recomienda no superar 20,000. Usa las tres semillas para comparar una etapa por vez, sin prometer repetición exacta. Revisa caras ocultas y aberturas.
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/text-to-3d",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"low_poly": false,
"quad_mesh": false,
"generate_pbr": true,
"generate_parts": false,
"texture_quality": "standard"
}
}'
# 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.










