# Présentation du Tripo API

Tripo3D est une plate-forme de génération 3D alimentée par AI- qui fournit des fonctionnalités de conversion de texte en 3D, d'image en 3D, de rigging, d'édition de maillage et d'autres fonctionnalités. Avec le Tripo API, les développeurs peuvent intégrer la génération de contenu 3D de haute qualité dans leurs propres produits.

> Si vous accédez depuis la Chine, veuillez visiter le site chinois : [developers.tripo3d.com](https://developers.tripo3d.com)

## Socle URL

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

## Authentification

Toutes les requêtes API doivent inclure un API Key dans l'en-tête de la requête :

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

Vous pouvez créer et gérer API Keys dans la [Console Tripo] (/en/keys).

## Format de réponse unifié

### Réponse réussie

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

### Réponse à l'erreur

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

### Champs communs

| Paramètre | Tapez | Descriptif |
| :-: | :-: | :-: |
| code | entier | Code d'état. `0` indique un succès et toute valeur non-`0` indique une erreur |
| data | objet | Données commerciales, renvoyées uniquement en cas de succès |
| message | chaîne | Description de l'erreur, renvoyée uniquement en cas d'échec |
| suggestion | chaîne | Correctif suggéré, renvoyé uniquement en cas d'échec |

## Modèle de tâche asynchrone

La plupart des API de génération utilisent un modèle de tâche asynchrone :

1. **Créer une tâche** - Envoyez une requête POST pour créer une tâche et recevoir un `task_id`
2. ** Sondage des résultats ** - Utilisez `GET /v3/tasks/{task_id}` pour interroger l'état et le résultat de la tâche

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

### Statuts des tâches

| Statut | Descriptif |
| :-: | :-: |
| `queued` | En file d'attente |
| `running` | Courir |
| `success` | Réussi |
| `failed` | Échec |
| `cancelled` | Annulé |

## Version API

Version actuelle : **v3**

## Présentation du point de terminaison

### Génération de modèles 3D

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`POST /v3/generation/text-to-model`](/en/docs/generation-text-to-model) | Générer un modèle 3D à partir de texte |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | Générer un modèle 3D à partir d'une image |
| [`POST /v3/generation/multiview-to-model`](/en/docs/generation-multiview-to-model) | Générer un modèle 3D à partir d'images multivues |

### Génération d'images

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`POST /v3/generation/text-to-image`](/en/docs/generation-text-to-image) | Générer une image à partir d'un texte |
| [`POST /v3/generation/image-to-image`](/en/docs/generation-image-to-image) | Transformer un style d'image |
| [`POST /v3/generation/image-to-multiview`](/en/docs/generation-image-to-multiview) | Générer des images multivues |
| [`POST /v3/generation/edit-multiview`](/en/docs/generation-edit-multiview) | Modifier des images multivues |

### Traitement du modèle

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`POST /v3/models/texture`](/en/docs/models-texture) | Texturer un modèle |
| [`POST /v3/models/convert`](/en/docs/models-convert) | Convertir le format du modèle |
| [`POST /v3/mesh/segment`](/en/docs/mesh-segment) | Segmentation sémantique |
| [`POST /v3/mesh/complete`](/en/docs/mesh-complete) | Achèvement du maillage |
| [`POST /v3/mesh/decimate`](/en/docs/mesh-decimate) | Retopologie |

### Animations

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | Vérifier la compatibilité de rigging |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | Monter un modèle |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | Recibler une animation |

### Gestion des tâches

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | Interroger une tâche |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | Tâches de requête par lots |

### Gestion des fichiers

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | Télécharger un fichier |

### Compte

| Point de terminaison | Descriptif |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | Rechercher le solde du compte |