Tripo3D

Présentation du Tripo API

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

Socle URL

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 :

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

Champs communs

Paramètre Tapez Descriptif
code entier Code d’état. 0 indique un succès et toute valeur non-0 indique une erreur
status chaîne error en cas d’échec
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
request_id chaîne Identifiant unique de la requête pour le dépannage, renvoyé 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 Générer un modèle 3D à partir de texte
POST /v3/generation/image-to-model Générer un modèle 3D à partir d’une image
POST /v3/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 Générer une image à partir d’un texte
POST /v3/generation/image-to-image Transformer un style d’image
POST /v3/generation/image-to-multiview Générer des images multivues
POST /v3/generation/edit-multiview Modifier des images multivues

Traitement du modèle

Point de terminaison Descriptif
POST /v3/models/texture Texturer un modèle
POST /v3/models/convert Convertir le format du modèle
POST /v3/mesh/segment Segmentation sémantique
POST /v3/mesh/complete Achèvement du maillage
POST /v3/mesh/decimate Retopologie

Animations

Point de terminaison Descriptif
POST /v3/animations/rig-check Vérifier la compatibilité de rigging
POST /v3/animations/rig Monter un modèle
POST /v3/animations/retarget Recibler une animation

Gestion des tâches

Point de terminaison Descriptif
GET /v3/tasks/{task_id} Interroger une tâche
POST /v3/tasks/list Tâches de requête par lots

Gestion des fichiers

Point de terminaison Descriptif
POST /v3/files Télécharger un fichier

Compte

Point de terminaison Descriptif
GET /v3/account/balance Rechercher le solde du compte
SuivantDémarrage rapide