Tripo H3.1 API

Acerca de Tripo H3.1

Formas 3D precisas y colores fieles a partir de una foto de producto.

Llámalo con el nombre de modelo tripo/h3.1/image-to-3d en POST /jobs/createTask, desde 0,432 US$.

Introducción

Tripo H3.1 es el modelo de imagen a 3D que Tripo AI presentó en marzo de 2026 para activos de nivel de producción, con geometría más nítida, mejor alineación con la imagen de entrada y texturas de mayor calidad que sus modelos anteriores de la serie H. Envías una imagen (image_url) y recibes un archivo glTF binario (.glb). A diferencia de los convertidores de un solo interruptor, cada etapa del proceso está expuesta: texturizar la malla o no, añadir mapas PBR, texturas HD, geometría detallada, topología de cuadriláteros, un número objetivo de caras, escalado real, la orientación final y dos semillas independientes. No hay prompt.

Características principales

Una forma que sigue a la imagen

En nuestra prueba de bota, el modelo mantuvo las proporciones de la foto y colocó el bucle del talón, los ganchos de los cordones y la suela en los lados correctos, aunque la foto solo mostraba el frente. El resultado texturizado trasladó el cuero desgastado, los cordones rojos y las costuras a la malla.

Texturas que puedes activar y mejorar

Las texturas vienen activadas por defecto y en un conjunto PBR completo. Nuestro archivo con ajustes predeterminados contenía, en un solo material, un mapa de color base de 2048 píxeles, un mapa de metal-rugosidad y un mapa de normales.

Topología y tamaño bajo 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 una herramienta de modelado, y geometry_quality: detailed dedica más cómputo al detalle fino de la superficie. auto_size escala la malla a dimensiones reales y model_orientation: align_image la gira para que coincida con la imagen.

Lo que medimos

Con los ajustes predeterminados, una vista frontal de una bota de cuero (1024×1024) volvió en 167 segundos como un GLB de 45,8 MB con 1 471 382 triángulos y tres texturas. Esa densidad es el motivo para definir face_limit en cualquier cosa que se muestre en un navegador.

Parámetros de la petición

Precios

Los precios se indican en USD. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.

Antes de ejecutar, envía el mismo cuerpo de petición a POST /jobs/quote para consultar el coste estimado y el máximo en USD. El presupuesto no ejecuta tareas ni carga tu saldo.

Casos de uso

Activos para juegos, AR y escenas en tiempo real

Ajusta face_limit al presupuesto de tu escena, activa quad_mesh si el activo se va a editar y mantén PBR activado para que el modelo reaccione a la iluminación de la escena.

Visualización de producto e impresión

Para un visor de producto, mantén las texturas activadas y usa texture_quality: detailed cuando las etiquetas o las costuras deban seguir siendo legibles. Para impresión 3D o escultura, desactiva ambos interruptores de textura y define auto_size para que la malla salga a escala realista.

Guía de prompts y consejos avanzados

Empieza con una imagen limpia

Un solo sujeto, completo en el encuadre, sobre fondo liso. Una vista de tres cuartos le da al modelo más información sobre la profundidad que una vista frontal recta. JPEG, PNG o WebP de hasta 10 MB.

Activa solo lo que necesites

Haz una primera pasada con los valores predeterminados y un face_limit, y mejora solo la etapa que se quede corta.

Itera con las dos semillas

seed fija la geometría y texture_seed fija 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 gíralo por completo antes de usarlo. Si el lado no visible es incorrecto, un ángulo de cámara distinto en la imagen de origen ayuda más que cualquier ajuste.

Inicio rápido de la API

Llama a la API de Tripo H3.1 en tres pasos

1. Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola API. Las claves empiezan por sk-popnow-. Las llamadas utilizan tu saldo independiente en dólares estadounidenses.
2. Envía la solicitud. Haz POST /jobs/createTask con model tripo/h3.1/image-to-3d y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
3. Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tripo/h3.1/image-to-3d",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "generate_texture": true,
    "generate_pbr": true,
    "texture_quality": "standard",
    "geometry_quality": "standard",
    "model_orientation": "default"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.

Preguntas sobre la API de Tripo H3.1

Otras API de imagen

• API de Seed3D 2.0Modelos 3D con texturas ricas a partir de una imagen, ideal para personajesDesde 0,48 US$ por generación

Más sobre Tripo H3.1

Pruébalo

Tripo H3.1: generador de imágenes con IA en líneaCrea imágenes con Tripo H3.1 en PopNow

Documentación

ID de modelo y esquema de entrada de Tripo H3.1 en la documentación de la APIInicio rápido con la API de PopNow: envía tu primera solicitudGuía de generación de imágenes con la API de PopNowWebhooks: recibe los resultados de Tripo H3.1 sin sondeos