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,
  "status": "error",
  "message": "You don't have enough credit to create this task",
  "suggestion": "Please purchase more credit",
  "request_id": "req_abc123"
}

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
status	cadena	`error` cuando la solicitud falla
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
request_id	cadena	Identificador de solicitud único para solución de problemas, devuelto 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:

Crear una tarea: envíe una solicitud POST para crear una tarea y reciba un task_id.
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