Tripo CLI : laissez l’IA transformer vos textes et images en modèles 3D

Tripo CLI est conçu pour les agents IA et rend la création 3D aussi simple qu’une conversation. Que ce soit dans un outil de codage IA comme Codex, Claude Code ou Cursor, ou directement via la CLI, une simple description en langage naturel, une image ou un modèle existant suffit pour générer ou transformer des modèles 3D, des animations et d’autres ressources. La CLI prend en charge l’ensemble du processus automatiquement — inutile de comprendre les API, les versions de modèles ou des paramètres complexes.

Dois-je utiliser la CLI ou l’API ?

Tripo existe en deux déclinaisons — prenez dix secondes pour choisir la bonne :

Produit	Idéal pour	Où aller
Tripo CLI (cette page)	Débutants : accédez rapidement aux capacités d’IA 3D via les outils de vibe coding populaires	Continuez la lecture
Tripo API	Développeurs professionnels : intégrez les capacités d’IA 3D à vos sites web, applications ou systèmes métier	Démarrage rapide

Vous hésitez ? Essayez d’abord cette page : l’installation est gratuite, et les crédits ne sont dépensés que lorsque vous générez réellement un modèle.

Installer et se connecter (deux méthodes au choix)

Choisissez l’une des deux méthodes d’installation ci-dessous.

Méthode 1 : laisser l’IA l’installer pour moi (recommandé)

Si vous utilisez déjà Cursor, Claude Code, Codex ou un autre assistant IA capable d’exécuter des commandes dans le terminal, c’est la méthode la plus simple. Copiez le prompt ci-dessous et envoyez-le intégralement à votre assistant :

Configure Tripo CLI pour moi et explique chaque étape. Vérifie que Node.js 20 ou une version ultérieure est installé, puis exécute npm install -g tripo-cli. Demande-moi ensuite de terminer tripo login dans le navigateur ; ne me demande pas de coller une clé API dans le chat. Enfin, exécute tripo doctor et indique-moi si les vérifications d’authentification, de réseau et de solde réussissent.

Voici ce qui se passe ensuite :

L’IA examine votre ordinateur et vous aide d’abord à installer Node.js s’il manque ;
L’IA exécute la commande d’installation ;
À vous de jouer : une fenêtre de navigateur ouvre la page de connexion Tripo — connectez-vous et approuvez le code de vérification affiché dans votre terminal (cette étape vous revient ; n’envoyez jamais aucune clé à l’IA) ;
L’IA exécute tripo doctor ; quand toutes les vérifications réussissent, la configuration est terminée.

Passez ensuite directement à la section suivante, « Créez votre premier modèle 3D ».

Un problème ? L’IA est bloquée ou a rencontré une erreur

Collez telle quelle l’erreur du terminal à l’IA et laissez-la continuer ; elle peut résoudre la plupart des problèmes ;
La connexion n’a pas abouti : rouvrez la page de connexion et revérifiez le code de vérification affiché dans votre terminal avant d’approuver ;
Si rien ne fonctionne, passez à la « Méthode 2 : l’installer moi-même » ci-dessous — elle ne compte que trois commandes.

Méthode 2 : l’installer moi-même

Pas d’assistant IA ? Aucun problème : tout le processus tient en trois commandes.

Étape 1 : installer Tripo CLI

Cette commande installe la commande tripo sur votre ordinateur :

Bash

npm install -g tripo-cli

Normalement, la progression se termine sans texte d’erreur rouge, signe que l’installation a réussi.

Un problème ? npm introuvable, ou erreur de permissions

npm introuvable : Node.js n’est pas encore installé. Installez la version LTS actuelle (20 ou plus) depuis le site de Node.js, puis rouvrez le terminal et réessayez ;
Erreur de permissions sur macOS (EACCES) : exécutez plutôt sudo npm install -g tripo-cli et saisissez le mot de passe de votre ordinateur quand il vous est demandé ;
Windows indique que « l’exécution de scripts est désactivée » : rouvrez PowerShell en tant qu’administrateur et réessayez.

Étape 2 : se connecter à votre compte Tripo

Bash

tripo login

Votre navigateur ouvre automatiquement une page d’autorisation (créez-y d’abord un compte si vous n’en avez pas encore). La page affiche un code de vérification — n’approuvez qu’après avoir confirmé qu’il correspond au code affiché dans votre terminal. Une fois la connexion effectuée, le terminal vous le confirme.

Page d’autorisation d’appareil de Tripo CLI dans le navigateur avec un code de vérification

Un problème ? Le navigateur ne s’est pas ouvert, ou la connexion n’a pas abouti

La connexion n’a pas abouti : exécutez à nouveau tripo login et n’approuvez qu’après avoir revérifié le code affiché dans votre terminal ;
Le navigateur ne réagit pas : copiez manuellement dans votre navigateur l’URL affichée dans le terminal ;
L’autorisation via le navigateur est temporairement indisponible : la CLI ouvre alors la page de clé API — voir « Connexion de secours et régions » à la fin de cette section.

Étape 3 : vérifier que tout est prêt

Bash

tripo doctor

La commande vérifie tour à tour votre connexion, l’accès réseau et votre solde de crédits. Quand les trois vérifications réussissent, la configuration est terminée.

Un problème ? L’une des vérifications a échoué

Échec de l’authentification : la connexion n’a pas abouti — exécutez tripo login et reconnectez-vous ;
Échec du réseau : vérifiez que votre ordinateur peut ouvrir des pages web ; les réseaux d’entreprise ou de campus peuvent nécessiter un proxy ;
Échec du solde : vous n’avez pas assez de crédits ; aucune génération n’a commencé et rien n’est facturé. Exécutez tripo topup pour ouvrir la page de facturation.

Connexion de secours et régions (uniquement si la connexion via le navigateur est indisponible)

Si vous avez déjà une clé API, exécutez tripo login --key tsk_... ou définissez la variable d’environnement TRIPO_API_KEY ;
Une clé API est un identifiant de compte : ne la collez jamais dans un chat, du code source, une capture d’écran ou un journal ;
La même installation fonctionne pour les comptes internationaux comme pour ceux de Chine continentale : la CLI teste les deux régions avec votre clé et enregistre automatiquement la région qui l’accepte.

Créez votre premier modèle 3D

Étape 1 : générer à partir d’une phrase

Les mots entre guillemets constituent votre prompt — remplacez-les par ce que vous voulez créer :

Bash

tripo make "a cute low poly fox"

Gardez le terminal ouvert pendant l’exécution de la commande. Tripo CLI choisit le bon flux et le bon modèle, attend la fin de la tâche et télécharge les fichiers dans un dossier tripo-out du répertoire courant. L’ensemble se termine généralement en quelques minutes et coûte une petite quantité de crédits.

Un problème ? La génération n’a pas démarré, ou a échoué en cours de route

Crédits insuffisants : la génération de votre modèle n’a pas commencé et rien n’est facturé. Exécutez tripo topup pour ajouter des crédits, puis réessayez ;
Erreur réseau : vérifiez que votre ordinateur est en ligne, puis relancez la même commande ;
Échec de la tâche : les crédits éventuellement débités sont automatiquement remboursés — essayez une autre description.

Étape 2 : ouvrir l’aperçu

Bash

tripo view @last

@last signifie « la tâche la plus récente ». Votre navigateur ouvre un aperçu 3D interactif que vous pouvez faire pivoter en glissant la souris — si votre modèle s’affiche, c’est gagné !

Après ce premier succès : ce que vous avez maintenant

Où sont les fichiers : un nouveau dossier sous tripo-out contient le modèle 3D téléchargé et task.json, qui enregistre comment la tâche a été créée ; si le serveur fournit une image d’aperçu, vous obtenez aussi preview.png.
Le rouvrir : exécutez tripo view @last à tout moment, ou tripo view <file> pour ouvrir n’importe quel fichier de modèle.
Ce que cela a coûté : exécutez tripo balance pour consulter votre solde de crédits.
Pas envie de mémoriser des commandes ? Exécutez simplement tripo pour ouvrir un menu interactif guidé — connexion, génération, aperçu et rechargement s’y trouvent tous.
Prochaines étapes : générer à partir d’images (section suivante), laisser un assistant IA piloter (« Aider les agents de codage IA à maîtriser la CLI ») ou traiter en masse (« Flux prêts à l’emploi et pipelines »).

Générer à partir d’une image ou d’un modèle existant

Une fois l’exemple textuel réussi, vous pouvez fournir des fichiers locaux à la place. concept.png, front.png et hero.glb ci-dessous sont des noms d’exemple — remplacez-les par les chemins de vos propres fichiers :

Bash

tripo make concept.png --for print
tripo make front.png back.png
tripo make hero.glb --then texture,rig
tripo make @last --then convert:fbx

Ligne 1 : transformer une image concept en modèle prêt pour l’impression ;
Ligne 2 : générer à partir des images de face et de dos ensemble, pour des détails plus fidèles ;
Ligne 3 : texturer et rigger un modèle existant ;
Ligne 4 : convertir le résultat le plus récent en FBX.

Aider les agents de codage IA à maîtriser la CLI

Si vous n’utilisez pas d’agent de codage IA, ignorez cette section. Le package npm inclut un Agent Skill — références de commandes, recettes par scénario et conseils de récupération après erreur — pour qu’un agent utilise la CLI correctement. Demandez à l’agent d’exécuter ces commandes pour afficher dans le terminal l’intégralité des instructions ou un sujet précis :

Bash

tripo docs --llm
tripo docs --topic commands/make
tripo docs --topic examples/game-asset

Fichiers inclus dans le Skill

skill/
├── SKILL.md
├── common-errors.md
├── commands/
│   ├── account.md
│   ├── batch.md
│   ├── generate.md
│   ├── make.md
│   ├── process.md
│   ├── task.md
│   └── view.md
└── examples/
    ├── animation.md
    ├── ar-web.md
    ├── film.md
    ├── game-asset.md
    ├── pipes.md
    └── print.md

Référence des commandes

Inutile de mémoriser ce tableau : au quotidien, les nouveaux utilisateurs n’ont besoin que de tripo (menu interactif), tripo make (génération), tripo view (aperçu) et tripo doctor (diagnostic). Ne dépliez le reste que lorsqu’un besoin précis se présente.

Afficher le tableau complet des commandes et les options courantes

Commande	Fonction
`tripo make <input...>`	Générer, traiter et télécharger avec une seule commande
`tripo ai [description]`	Planifier une tâche, la confirmer et l’exécuter
`tripo view [task\|file]`	Ouvrir un aperçu 3D local interactif
`tripo redo [task]`	Répéter une requête avec une nouvelle graine
`tripo login / logout / whoami / use`	Autoriser des profils de compte nommés et passer de l’un à l’autre
`tripo topup / balance / usage`	Ouvrir la facturation régionale et consulter les crédits
`tripo generate <endpoint>`	Accéder explicitement aux huit points de terminaison de génération
`tripo model / anim / mesh <step>`	Exécuter l’affinage, le texturage, le rigging, la conversion, la segmentation et d’autres étapes de traitement
`tripo task get/list/watch`	Interroger, répertorier ou attendre des tâches
`tripo history [--limit <n>]`	Afficher l’historique local des tâches récentes
`tripo files upload <path>`	Téléverser un fichier et renvoyer son `file_token`
`tripo batch run <manifest.yaml>`	Exécuter des pipelines en masse pouvant reprendre, avec concurrence et nouvelles tentatives
`tripo config / doctor`	Gérer les paramètres et diagnostiquer l’environnement local
`tripo docs [--topic <topic>]`	Afficher la documentation incluse de l’Agent et des commandes
`tripo mcp`	Exécuter la CLI en tant que serveur MCP
`tripo completion <shell>`	Générer l’autocomplétion pour Bash, Zsh ou Fish

Les commandes make, ai et generate, ainsi que les sous-commandes de traitement de model, anim et mesh, prennent en charge -o/--out, --no-wait, --no-download, --name, --timeout, --notify et l’option répétable --param key=value. Les options globales d’automatisation comprennent --json, --yes, --quiet, --no-open et --profile.

Flux prêts à l’emploi et pipelines

Cette section est avancée ; votre première génération n’en a pas besoin. Sept préréglages intégrés appliquent d’un coup des paramètres et des étapes de traitement utiles via --for <preset> :

game-mobile · game-pc · film · print · ar-web · anim · toy

Bash

# Mobile game asset: low-poly generation, texture, then FBX
tripo make "sci-fi crate" --for game-mobile

# Print asset: watertight output, STL, and a flat bottom
tripo make "chess knight" --for print

# Explicit processing chain
tripo make cat.png --then texture,rig,convert:fbx

# The same chain as NDJSON pipes
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json

# Resumable batch processing
tripo batch run assets.yaml --concurrency 2

Les références de tâches telles que @last, @2 et @name fonctionnent partout où un ID de tâche est accepté.

Plusieurs comptes et régions

Si vous n’utilisez qu’un seul compte Tripo, ignorez cette section. Les identifiants sont stockés dans des profils nommés : la connexion à un deuxième compte ne remplace donc pas le premier.

Bash

tripo login
tripo login --profile work-cn
tripo use
tripo whoami
tripo make "a fox" --profile work-cn
tripo logout

Chaque profil conserve sa propre clé et sa propre région. La variable d’environnement TRIPO_PROFILE sélectionne un profil pour l’environnement courant, tandis que TRIPO_API_KEY contourne tous les profils et a la priorité la plus élevée.

Notes pour les agents de codage IA

Les utilisateurs humains peuvent ignorer cette section. Ces règles aident un agent de codage IA à attendre correctement les tâches et à lire les sorties lisibles par machine.

tripo make et tripo task watch sont des commandes bloquantes. Attendez la fin du processus au lieu d’implémenter une autre boucle d’interrogation.
Avec --json, la plupart des commandes ponctuelles écrivent une ligne JSON finale dans stdout. En revanche, tripo task watch --json diffuse des événements de progression NDJSON, puis le résultat final.
Si preview.png existe, examinez-le avant de décider de poursuivre un pipeline ou d’exécuter tripo redo.
N’inventez pas de paramètres et ne forcez pas d’anciennes versions de modèles. Utilisez tripo docs --topic ... pour connaître les options prises en charge.
Une requête low-poly ou un budget de faces inférieur ou égal à 20 000 sélectionne tripo-p1 ; les autres tâches utilisent tripo-v3.1 par défaut.

Afficher le tableau des codes de sortie

Code de sortie	Signification
`0`	Réussite
`1`	Erreur inattendue ou interne
`2`	Utilisation ou paramètres non valides
`3`	Erreur d’authentification
`4`	Crédits insuffisants
`5`	Rejet par la politique de contenu
`6`	Échec de la tâche ; les crédits sont automatiquement remboursés
`7`	Erreur réseau
`8`	Ressource introuvable
`9`	Limite de débit atteinte ; réessayez avec temporisation

Variables d’environnement pour l’automatisation

Les variables d’environnement ne sont pas nécessaires en usage interactif normal ; elles servent à la CI, aux scripts et aux workflows d’agents avancés. Rappel : ne validez jamais une clé API dans un dépôt, ne la collez pas dans la documentation et ne l’incluez pas dans des captures d’écran ou des journaux.

Afficher le tableau des variables d’environnement

Variable	Rôle
`TRIPO_API_KEY`	Clé API ; priorité la plus élevée et adaptée à la CI ou aux Agents
`TRIPO_PROFILE`	Profil de compte nommé, équivalent à `--profile`
`TRIPO_REGION`	Remplacement facultatif par `ov` ou `cn` ; normalement détecté automatiquement
`TRIPO_API_BASE_URL`	Remplacement du point de terminaison de l’API
`TRIPO_PLATFORM_BASE_URL`	Remplacement du point de terminaison de la plateforme
`TRIPO_HOME`	Répertoire de configuration et d’historique ; `~/.tripo` par défaut
`TRIPO_LLM_BASE_URL`	Point de terminaison facultatif compatible avec OpenAI pour `tripo ai`
`TRIPO_LLM_API_KEY`	Clé LLM facultative pour `tripo ai`
`TRIPO_LLM_MODEL`	Modèle LLM facultatif pour `tripo ai`