Skip to main content
La generación 3D es asincrónica. POST /v1/3d/generations crea una tarea de TokenLab; las respuestas de estado completadas devuelven activos de modelo descargables como model_url y, cuando están disponibles, URLs específicas de formato.

​
Elegir El Tipo De Entrada

Consulta el catálogo de modelos antes de decidir qué opciones exponer: Usa el tipo de entrada en lugar de un campo operation para este endpoint. Los metadata del modelo informan las capacidades 3D como text-to-3d y/o image-to-3d; 3d-generation no es una operación pública de solicitud.
Ejemplos actuales de Tripo incluyen tripo-h3.1 para flujos text/image-to-3D de alta calidad y tripo-p1.0 para generacion de assets 3D de estilo produccion. Usa Models API para confirmar el tipo de entrada y formato de salida. No asumas que cada modelo 3D soporta ambos tipos de entrada o cada formato de salida. Verifica el detalle del modelo seleccionado antes de enviar image, image_url, format, quality, style o seed.

​
Crear Una Tarea 3D

Para imagen a 3D, usa un image_url público cuando sea posible. Usa image en línea/base64 solo cuando tu cliente envíe intencionalmente medios privados y tu backend esté preparado para cuerpos de solicitud más grandes.

​
Opciones De Formato De Salida

  • glb es generalmente el valor predeterminado más seguro para vistas previas web.
  • fbx y obj son útiles para flujos de trabajo DCC cuando el modelo seleccionado los soporte.
  • usdz es útil para flujos de trabajo de AR de Apple cuando es expuesto por el modelo.
  • Valores de quality más altos pueden aumentar la latencia y el costo. Exponlos como opciones explícitas para el usuario, no como valores predeterminados ocultos.
  • seed es útil para la reproducibilidad solo cuando el modelo lo respeta.

​
Consultar Y Almacenar Activos

Usa primero el poll_url devuelto. Si tu cliente necesita una ruta fija, usa GET /v1/tasks/{id}.
Las tareas completadas devuelven model_url y pueden incluir glb_url, fbx_url, obj_url o usdz_url. Descarga o almacena el activo seleccionado en tu propio producto si los usuarios necesitan acceso repetido, historial de versiones o descargas prolongadas.

​
Lista De Verificación De Producción

  • Persiste task_id, poll_url, modelo, formato solicitado y tu propio ID de registro de activo.
  • Reanuda la consulta después de la actualización de la página en lugar de crear una tarea duplicada.
  • Valida el tamaño y la accesibilidad de la imagen de origen antes de crear la tarea.
  • Mantén las URLs de activos generados fuera de las páginas públicas a menos que el usuario tenga permiso para acceder al activo.
  • Registra billing_transaction_id cuando esté presente para una reconciliación posterior.

​
Errores Comunes

​
Referencia API