# 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](https://developers.tripo3d.com)

## Base URL

```baseurl
https://openapi.tripo3d.ai/v3
```

## Autenticación

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

```apikey
Authorization: Bearer {api_key}
```

Puede crear y administrar API Keys en la [Consola Tripo](/en/keys).

## 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`](/en/docs/generation-text-to-model) | Generar un modelo 3D a partir de texto |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | Generar un modelo 3D a partir de una imagen |
| [`POST /v3/generation/multiview-to-model`](/en/docs/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`](/en/docs/generation-text-to-image) | Generar una imagen a partir de texto |
| [`POST /v3/generation/image-to-image`](/en/docs/generation-image-to-image) | Transformar un estilo de imagen |
| [`POST /v3/generation/image-to-multiview`](/en/docs/generation-image-to-multiview) | Generar imágenes multivista |
| [`POST /v3/generation/edit-multiview`](/en/docs/generation-edit-multiview) | Editar imágenes de vista múltiple |

### Procesamiento de modelos

| Punto final | Descripción |
| :-: | :-: |
| [`POST /v3/models/texture`](/en/docs/models-texture) | Texturizar un modelo |
| [`POST /v3/models/convert`](/en/docs/models-convert) | Convertir formato de modelo |
| [`POST /v3/mesh/segment`](/en/docs/mesh-segment) | Segmentación semántica |
| [`POST /v3/mesh/complete`](/en/docs/mesh-complete) | Terminación de malla |
| [`POST /v3/mesh/decimate`](/en/docs/mesh-decimate) | Retopología |

### Animación

| Punto final | Descripción |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | Comprobar compatibilidad de rigging |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | Armar un modelo |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | Reorientar una animación |

### Gestión de tareas

| Punto final | Descripción |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | Consultar una tarea |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | Consultar tareas por lotes. |

### Gestión de archivos

| Punto final | Descripción |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | Subir un archivo |

### cuenta

| Punto final | Descripción |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | Consultar saldo de cuenta |