Tripo3D

Introducción al Tripo API

Introducción al Tripo API

Tripo3D es una plataforma de generación 3D impulsada por AI- que proporciona conversión de texto a 3D, imagen a 3D, rigging, edición de malla y otras capacidades. Con Tripo API, los desarrolladores pueden integrar la generación de contenido 3D de alta calidad en sus propios productos.

Si accede desde China, visite el sitio de China: developers.tripo3d.com

Base URL

https://openapi.tripo3d.ai/v3

Autenticación

Todas las solicitudes API deben incluir API Key en el encabezado de la solicitud:

Authorization: Bearer {api_key}

Puede crear y administrar API Keys en la Consola Tripo.

Formato de respuesta unificado

Respuesta exitosa

JSON
{
  "code": 0,
  "data": {
    ...
  }
}

Respuesta de error

JSON
{
  "code": 2010,
  "message": "Insufficient credits",
  "suggestion": "Please top up your account"
}

Campos comunes

Parámetro Tipo Descripción
code entero Código de estado. 0 indica éxito y cualquier valor que no sea 0 indica un error
data objeto Datos comerciales, devueltos solo en caso de éxito
message cadena Descripción del error, devuelta solo en caso de error
suggestion cadena Solución sugerida, devuelta solo en caso de error

Patrón de tarea asincrónica

La mayoría de los API de generación utilizan un patrón de tarea asincrónico:

  1. Crear una tarea: envíe una solicitud POST para crear una tarea y reciba un task_id.
  2. Encuesta para obtener resultados: utilice GET /v3/tasks/{task_id} para consultar el estado y el resultado de la tarea.
POST /v3/generation/text-to-model  ->  {"code": 0, "data": {"task_id": "task_abc123"}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "running", "progress": 50}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "success", "output": {...}}}

Estados de tareas

Estado Descripción
queued En cola
running corriendo
success Tuvo éxito
failed Fallido
cancelled Cancelado

Versión API

Versión actual: v3

Descripción general del punto final

Generación de modelos 3D

Punto final Descripción
POST /v3/generation/text-to-model Generar un modelo 3D a partir de texto
POST /v3/generation/image-to-model Generar un modelo 3D a partir de una imagen
POST /v3/generation/multiview-to-model Generar un modelo 3D a partir de imágenes multivista

Generación de imágenes

Punto final Descripción
POST /v3/generation/text-to-image Generar una imagen a partir de texto
POST /v3/generation/image-to-image Transformar un estilo de imagen
POST /v3/generation/image-to-multiview Generar imágenes multivista
POST /v3/generation/edit-multiview Editar imágenes de vista múltiple

Procesamiento de modelos

Punto final Descripción
POST /v3/models/texture Texturizar un modelo
POST /v3/models/convert Convertir formato de modelo
POST /v3/mesh/segment Segmentación semántica
POST /v3/mesh/complete Terminación de malla
POST /v3/mesh/decimate Retopología

Animación

Punto final Descripción
POST /v3/animations/rig-check Comprobar compatibilidad de rigging
POST /v3/animations/rig Armar un modelo
POST /v3/animations/retarget Reorientar una animación

Gestión de tareas

Punto final Descripción
GET /v3/tasks/{task_id} Consultar una tarea
POST /v3/tasks/list Consultar tareas por lotes.

Gestión de archivos

Punto final Descripción
POST /v3/files Subir un archivo

cuenta

Punto final Descripción
GET /v3/account/balance Consultar saldo de cuenta