Tripo
Tripo H3.1
tripo-h3.1/text-to-3d
Modelo de generación 3D de alto detalle de Tripo que permite crear activos 3D con textura a partir de indicaciones de texto, una sola imagen o varias vistas; permite ajustar el número de caras y la calidad de la textura, ofrece materiales PBR y resulta adecuado para la producción de activos como objetos de juego y visualización de productos
Probar tripo-h3.1/text-to-3d
Entrada
Salida
Precios
tripo-h3.1/text-to-3d per model
+ $0.290 geometría más fina · si se selecciona detallada
Descripción general
Se trata de un servicio de generación de modelos 3D a partir de texto: los desarrolladores solo tienen que introducir una descripción en lenguaje natural para obtener un recurso de modelo 3D con texturas. El prompt admite hasta 1024 caracteres, permite excluir contenido no deseado mediante un prompt negativo y ofrece la posibilidad de establecer por separado la calidad de la geometría y de las texturas, si se emiten materiales PBR, el límite máximo de triángulos y varias semillas aleatorias para reproducir los resultados. Los resultados generados son adecuados para prototipos de juegos, visualización de productos, diseño conceptual y otros escenarios en los que se necesita convertir rápidamente una idea textual en un modelo 3D; está orientado a desarrolladores de contenido 3D, creadores independientes y equipos de diseño.
Puntos clave
- Generación directa de recursos 3D a partir de texto: basta con introducir una descripción para producir un modelo 3D con geometría y texturas, lo que elimina el primer paso del modelado manual.
- Calidad de geometría y de texturas ajustable por separado: tanto la calidad de la geometría como la de las texturas cuentan con dos niveles, estándar y detallado, lo que permite equilibrar el detalle y el volumen de producción según el uso previsto.
- Compatibilidad con materiales PBR e interruptores de texturas: de forma predeterminada se generan materiales PBR y texturas; también es posible desactivar simultáneamente las texturas y PBR para conservar únicamente una malla puramente geométrica, adaptándose a distintos flujos de trabajo posteriores.
- El parámetro de semilla permite reproducir resultados: la imagen conceptual, la geometría y las texturas disponen cada una de una semilla aleatoria, lo que facilita repetir o ajustar ligeramente los resultados con la misma configuración.
Descripción de las capacidades
Generación de modelos 3D a partir de descripciones de texto: construye geometría 3D a partir del prompt; el prompt admite hasta 1024 caracteres y se puede complementar con un prompt negativo para excluir elementos no deseados, lo que resulta adecuado para crear recursos conceptuales desde cero.
Control del objetivo de número de triángulos: mediante el parámetro de límite de caras se puede especificar el número objetivo de triángulos, con un rango de 1000 a 1,5 millones (2 millones con geometría detallada); si no se establece, el modelo lo decide de forma adaptativa, lo que facilita ajustarse a los requisitos de renderizado posteriores.
Salida de materiales PBR y texturas: de forma predeterminada se generan materiales PBR y texturas; si se desactivan simultáneamente las texturas y PBR, se obtiene una malla puramente geométrica. La calidad de las texturas puede ser estándar o detallada; el nivel detallado produce texturas de mayor resolución.
Nivel de detalle geométrico ajustable: la calidad de la geometría puede elegirse entre estándar y detallada; el nivel detallado añade detalles de malla más finos, adecuado para recursos que requieren presentación en primer plano o un refinamiento posterior.
Casos de uso
- Producción rápida de modelos de objetos para prototipos de juegos: diseñadores de juego o desarrolladores independientes describen con texto la apariencia de un objeto y generan un modelo 3D con texturas que importan al motor para validar prototipos y construir niveles.
- Creación de recursos conceptuales para visualización de productos: los equipos de diseño generan modelos 3D a partir de descripciones de productos para presentaciones tempranas de propuestas, borradores visuales de marketing y revisiones internas.
- Iteración de diseño conceptual 3D: los diseñadores conceptuales generan variantes por lotes con distintos prompts y semillas para comparar rápidamente direcciones de modelado y seleccionar los recursos que pasan a la fase de refinamiento.
Limitaciones y recomendaciones de selección
La longitud del prompt está limitada a entre 1 y 1024 caracteres; si se supera, no se puede enviar. El límite de caras solo acepta números enteros entre 1000 y 1,5 millones (2 millones con geometría detallada); si no se establece, el modelo decide por sí mismo el número de triángulos. La calidad de las texturas y la calidad de la geometría son opciones de elección única entre dos niveles, y en cada solicitud solo se puede elegir uno de ellos. Si se desactivan tanto las texturas como PBR, el resultado es una malla puramente geométrica sin mapas de superficie. El parámetro de semilla sirve para mejorar la reproducibilidad, pero una misma semilla no garantiza que los resultados generados sean idénticos.
Novedades
Ver el registro de cambios →- Nuevo modelo tripo-h3.1/multiview-to-3d disponible: Tripo H3.1 generación de 3D a partir de múltiples vistas
- Nuevo modelo tripo-h3.1/text-to-3d ya disponible: Tripo H3.1 texto a 3D
- Nuevo modelo tripo-h3.1/image-to-3d disponible: Tripo H3.1 de imagen a 3D
Preguntas frecuentes
Ver todas las preguntas →-
¿Cuál es el límite máximo de caras? ¿Puede llegar a 2 millones?
Sí, el límite de face_limit es de 2 millones de triángulos, pero solo se admite realmente hasta 2 millones cuando geometry_quality está configurado como detailed; con standard se recomienda configurarlo por debajo de 1,5 millones. Si no se pasa face_limit, el modelo decide el número de caras de forma adaptativa.
-
¿Cómo puedo obtener primero solo una geometría sin texturas?
Basta con establecer texture y pbr en false; cuando pbr es true se generan texturas de forma forzada. Si necesitas texturas pero no materiales PBR, establece texture en true y pbr en false.
-
¿Es necesario activar un parámetro independiente para la geometría de alta densidad?
Establecer geometry_quality en detailed añade un mayor nivel de detalle en la malla y es también el requisito previo para que el número de polígonos pueda llegar a 2 millones; si se necesitan texturas más refinadas, establece texture_quality en detailed. Ambos tienen standard como valor predeterminado y se activan según los requisitos de plano cercano del activo objetivo.
-
¿Cómo puedo reproducir los resultados de generación para comparar distintos parámetros?
La geometría y las texturas tienen cada una su semilla fija: model_seed controla la geometría y texture_seed controla las texturas; la generación de 3D a partir de texto tiene además image_seed, que controla la imagen conceptual. Al comparar ajustes de parámetros, primero fija las semillas y modifica solo un parámetro, así podrás determinar de qué elemento proviene la diferencia.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: tripo-h3.1/text-to-3d
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para tripo-h3.1/text-to-3d y la ruta default; consulta la tabla de parámetros a continuación.
pbrbooleanOpcionalPredeterminado: trueIndica si se debe generar material PBR; toma un valor booleano, por defecto true; cuando es true, también se generan las texturas.
promptstringObligatoriominLength 1maxLength 1024Texto descriptivo del objeto que se va a generar, por ejemplo, una pequeña tetera de cerámica, como indicación de entrada para la generación de 3D a partir de texto.
texturebooleanOpcionalPredeterminado: trueIndica si se generan texturas para el modelo; por defecto true. Ten en cuenta que cuando pbr es true se fuerza la generación de texturas; solo cuando tanto texture como pbr se establecen en false se genera una malla puramente geométrica.
face_limitintegerOpcionalmin 1000max 2000000Número objetivo de caras triangulares, valor entero, rango de 1000 a 1500000 (máximo 2000000 cuando geometry_quality=detailed); si se omite, el modelo decide el número de caras de forma adaptativa; el archivo suele ser grande, por lo que para visualización web se recomienda alrededor de 50000.
image_seedintegerOpcionalSemilla aleatoria para la generación de la imagen conceptual, valor entero, utilizada para reproducir el resultado de la misma imagen conceptual.
model_seedintegerOpcionalSemilla aleatoria reproducible para la generación de geometría, valor entero, utilizada para reproducir de forma estable el mismo resultado geométrico.
texture_seedintegerOpcionalSemilla aleatoria reproducible para la generación de texturas, valor entero, utilizada para reproducir de forma estable el mismo resultado de textura.
negative_promptstringOpcionalmaxLength 1024Indicación negativa, describe el contenido que se debe evitar durante la generación.
texture_qualitystringOpcionalPredeterminado: "standard"Nivel de calidad de textura, valor de cadena, por defecto standard; el nivel detailed genera texturas de mayor resolución.
standarddetailedgeometry_qualitystringOpcionalPredeterminado: "standard"Nivel de calidad geométrica, valor de cadena, por defecto standard; el nivel detailed ofrece detalles de malla más finos.
standarddetailedcallbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tripo-h3.1/text-to-3d",
input: {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": True,
"prompt": "…",
"texture": True,
"texture_quality": "standard",
"geometry_quality": "standard"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Comparativa
Comparativa horizontal y guía de selección de Tripo H3.1: cómo elegir y ahorrar entre tres rutas de generación 3D
Un análisis de precios y capacidades para desarrolladores, partiendo de la forma de entrada, el refinado geométrico y los interruptores de PBR/textura
-
Tutorial
Casos prácticos de Tripo H3.1: 5 usos de alto valor y puntos clave de implementación
De texto a 3D a la reconstrucción multivista: elige el modo y los parámetros correctos según el escenario de negocio
-
Guía de uso
Guía de inicio de Tripo H3.1: cómo elegir entre tres modos de entrada, parámetros y precios
Guía práctica de decisiones de integración y control de costes de la generación 3D para desarrolladores