# Introduzione allo Tripo API

Tripo3D è una piattaforma di generazione 3D basata su AI- che fornisce conversione di testo in 3D, conversione di immagini in 3D, rigging, modifica di mesh e altre funzionalità. Con Tripo API, gli sviluppatori possono integrare la generazione di contenuti 3D di alta qualità nei propri prodotti.

> Se accedi dalla Cina, visita il sito cinese: [developers.tripo3d.com](https://developers.tripo3d.com)

## Base URL

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

## Autenticazione

Tutte le richieste API devono includere un API Key nell'intestazione della richiesta:

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

È possibile creare e gestire API Keys nella [Console Tripo](/en/keys).

## Formato di risposta unificato

### Risposta di successo

```json
{
  "code": 0,
  "data": {
    ...
  }
}
```

### Risposta all'errore

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

### Campi comuni

| Parametro | Digitare | Descrizione |
| :-: | :-: | :-: |
| code | intero | Codice di stato. `0` indica successo e qualsiasi valore diverso da `0` indica un errore |
| data | oggetto | Dati aziendali, restituiti solo in caso di successo |
| message | stringa | Descrizione dell'errore, restituita solo in caso di errore |
| suggestion | stringa | Correzione suggerita, restituita solo in caso di errore |

## Modello di attività asincrona

La maggior parte degli API di generazione utilizza uno schema di attività asincrono:

1. **Crea un'attività**: invia una richiesta POST per creare un'attività e ricevere un `task_id`
2. **Sondaggio per risultati**: utilizza `GET /v3/tasks/{task_id}` per interrogare lo stato dell'attività e il risultato

```
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": {...}}}
```

### Stati delle attività

| Stato | Descrizione |
| :-: | :-: |
| `queued` | In coda |
| `running` | Correre |
| `success` | Riuscito |
| `failed` | Fallito |
| `cancelled` | Annullato |

## Versione API

Versione attuale: **v3**

## Panoramica degli endpoint

### Generazione di modelli 3D

| Punto finale | Descrizione |
| :-: | :-: |
| [`POST /v3/generation/text-to-model`](/en/docs/generation-text-to-model) | Genera un modello 3D dal testo |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | Genera un modello 3D da un'immagine |
| [`POST /v3/generation/multiview-to-model`](/en/docs/generation-multiview-to-model) | Genera un modello 3D da immagini multivista |

### Generazione di immagini

| Punto finale | Descrizione |
| :-: | :-: |
| [`POST /v3/generation/text-to-image`](/en/docs/generation-text-to-image) | Genera un'immagine dal testo |
| [`POST /v3/generation/image-to-image`](/en/docs/generation-image-to-image) | Trasforma uno stile di immagine |
| [`POST /v3/generation/image-to-multiview`](/en/docs/generation-image-to-multiview) | Genera immagini multivista |
| [`POST /v3/generation/edit-multiview`](/en/docs/generation-edit-multiview) | Modifica immagini multivista |

### Elaborazione del modello

| Punto finale | Descrizione |
| :-: | :-: |
| [`POST /v3/models/texture`](/en/docs/models-texture) | Texture un modello |
| [`POST /v3/models/convert`](/en/docs/models-convert) | Converti il formato del modello |
| [`POST /v3/mesh/segment`](/en/docs/mesh-segment) | Segmentazione semantica |
| [`POST /v3/mesh/complete`](/en/docs/mesh-complete) | Completamento della mesh |
| [`POST /v3/mesh/decimate`](/en/docs/mesh-decimate) | Retopologia |

### Animazione

| Punto finale | Descrizione |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | Verifica la compatibilità del rigging |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | Prepara un modello |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | Reindirizzare un'animazione |

### Gestione delle attività

| Punto finale | Descrizione |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | Interroga un'attività |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | Interrogare le attività in batch |

### Gestione dei file

| Punto finale | Descrizione |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | Carica un file |

### Conto

| Punto finale | Descrizione |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | Interroga il saldo del conto |