Modèles Tripo3D, finalisés dans Blender
Tripo3D transforme une image ou une invite en un maillage texturé en environ une minute. Chaque exécution coûte des crédits, ses contrôles sont grossiers, et une nouvelle version du modèle donne un maillage différent pour la même requête. Blender est gratuit et précis, et un script donne le même résultat à chaque fois. Prenez donc le maillage de base de Tripo3D une fois, gardez-le, et effectuez tous les réglages dans Blender. Ne payez pour une nouvelle exécution que lorsque la forme est erronée. La taille, l'orientation, une main bosselée, une teinte de texture et un budget de triangles sont tous des corrections dans Blender.
Testé le 2026-11-20 avec tripo-cli 0.11.2, Blender 5.3.0 et Node 24 sur
macOS. Si tripo --version affiche une version plus récente, faites confiance à
tripo docs --topic commands/make plutôt qu'à ce fichier pour les indicateurs.
Fichiers de référence
Ce fichier prend un modèle de l'installation à un GLB finalisé. Ouvrez une référence uniquement lorsque la tâche nécessite son détail.
| Référence | Ouvrez-la lorsque vous | Lignes |
|---|---|---|
| configuration | installez ou connectez-vous, ajoutez le serveur MCP, travaillez sous Linux, ou êtes tenté par une autre route Tripo | 146 |
| images | créez les images d'entrée pour un modèle qui doit correspondre à une image cible, et les faites réviser | 123 |
| génération | choisissez un modèle ou des paramètres, utilisez plusieurs images, enchaînez les propres étapes de Tripo, ou comptez les crédits | 146 |
| blender | corrigez un modèle généré, travaillez dans un Blender en direct, ou intégrez ces étapes dans la construction d'un projet | 283 |
| erreurs | lisez le code de sortie d'une commande ayant échoué, ou une erreur de script Blender | 43 |
Les deux scripts exécutés par ce fichier se trouvent dans tools/ à côté de lui. Ci-dessous, <skill-dir>
désigne le dossier qui contient ce SKILL.md.
1. Ce qu'un humain doit faire en premier
Un agent ne peut pas faire ces actions. Demandez-les avant d'exécuter quoi que ce soit.
-
Un compte API Tripo3D payant, sur https://developers.tripo3d.ai (international) ou https://developers.tripo3d.com (Chine continentale). Les crédits API sont distincts des crédits Tripo Studio. Payant est important pour les droits : les conditions de Tripo accordent aux utilisateurs payants les droits sur leurs sorties, publication et vente incluses (section 5.2.2), et conservent les sorties des utilisateurs gratuits pour Tripo (section 5.2.1).
-
La clé API dans le coffre-fort de secrets du système. Sur macOS, l'humain exécute ceci et tape la clé à l'invite, de sorte que la clé ne passe jamais par le chat :
security add-generic-password -a "$USER" -s tripo3d-api-key -wSans clé, la connexion par navigateur dans configuration fonctionne aussi.
-
Blender 5.x, avec
blenderdans le PATH. Le contrôle en direct nécessite également le module complémentaire Blender Lab MCP avec Allow Online Access activé ; voir blender.
Ne demandez jamais la clé dans le chat, et ne l'écrivez jamais dans un fichier que vous créez. Lisez-la à partir du coffre-fort de secrets en ligne, comme le fait la section 2.
2. Configurer Tripo3D
Une fois par machine :
node --version # nécessite 20 ou ultérieur
npm install -g tripo-cli # installe la commande `tripo`
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<caché>/g'
tripo doctor # chaque vérification "ok": true
tripo login --key essaie les deux régions, garde celle qui accepte la clé et
l'enregistre dans ~/.tripo/config.json avec le mode 0600, donc aucune commande ultérieure n'a besoin
de la clé. Un solde nul dans tripo doctor est un avertissement, pas un échec.
Utilisez tripo-cli, l'outil officiel de Tripo, pour chaque appel Tripo. L'ancien
serveur Tripo-Developer/tripo-mcp plante au démarrage et pilote un module complémentaire Blender
qui n'existe plus. Le module complémentaire Tripo Bridge dans Blender ne prend que les
modèles qu'une personne envoie depuis le site web Tripo.
configuration donne le détail.
3. Générer un modèle de base
Choisissez l'entrée. Une image de l'objet entier, seul, sur un fond
uni, dans une vue de face ou trois-quarts. Deux à quatre images couvrent les
côtés cachés ; nommez les fichiers front, left, back et right. Le
modèle copie la forme, la surface et la couleur de l'image, donc l'usure, la mousse et la couleur
doivent être dans l'image. Une invite entre guillemets fonctionne aussi, avec moins de contrôle.
Faites réviser les images avant de payer. Un défaut dans une image se retrouve dans le maillage, et une nouvelle exécution coûte à nouveau les crédits. Lorsque l'humain donne une cible, comme un concept art ou une photo, et souhaite que le modèle y corresponde :
- rédigez une liste de contrôle à partir de la seule cible : ce que chaque partie montre, ce qui échoue, et les ratios et couleurs qui peuvent être mesurés ;
- créez deux à huit nouvelles images candidates pour chaque vue, d'abord la face, puis les autres vues à partir de la face réussie ;
- donnez la cible, la liste de contrôle et les candidats à un réviseur séparé, un autre agent ou une personne qui ne les a pas créés, dont le travail est de les faire échouer ;
- exécutez Tripo3D uniquement sur les images qui ont réussi, et notez les points que le réviseur a laissés passer, pour la finalisation dans Blender.
images contient la boucle, comment briefier le réviseur, ce qui fait échouer une image et comment en mesurer une.
Choisissez le modèle. Sans --model, chaque exécution utilise P2, qui coûte environ
trois fois plus que H3.1.
| Modèle | Indicateur | Estimation à sec | Utilisez-le pour |
|---|---|---|---|
| H3.1 | --model tripo-v3.1 | 10 à 50 crédits ; une image avec des cartes PBR détaillées est de 40 | Objets solides détaillés : statues, accessoires, rochers |
| P2 (par défaut) | --model tripo-p2 | 100 à 130 crédits ; une image simple est de 110 | Topologie propre en quads, faible polygone |
Testez à sec. Un test à sec n'envoie rien et ne dépense rien :
tripo make ref.png --model tripo-v3.1 --seed 7 \
-p face_limit=30000 -p pbr=true -p texture_quality=detailed \
-p texture_version=v3.5-20260815 -p delight=true \
--name statue -o tripo-out/statue --dry-run --json
valid doit être true et errors vide. Chaque entrée dans warnings est un
paramètre que le CLI a supprimé, donc cette exigence ne sera pas satisfaite ; réglez-la
avant de payer. generation_credits_estimate est le prix catalogue de la
seule génération.
Exécutez-le sans --dry-run. La commande bloque jusqu'à ce que le modèle,
preview.png et task.json soient dans le dossier -o, puis imprime une ligne
JSON. Prenez le chemin du modèle depuis son champ model_file, car le nom du fichier
change avec les options (pbr_model.glb, par exemple). Regardez
preview.png avant de continuer.
Conservez le résultat brut. Les liens de téléchargement expirent après environ cinq minutes, et une version ultérieure du modèle donne un autre maillage à partir de la même graine, donc les fichiers téléchargés sont la seule copie :
mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/ # modèle, task.json, preview.png
Validez ce dossier, ou conservez-le avec les actifs source du projet. Chaque étape Blender lit cette copie et jamais le réseau, donc une reconstruction donne les mêmes fichiers.
Arrêtez-vous et demandez à l'humain :
- avant toute exécution estimée à plus de 50 crédits, toute exécution P2, et tout lot dont les estimations totalisent plus de 150 crédits ;
- après le code de sortie 4, crédits insuffisants, car chaque nouvelle tentative échoue de la même
manière : donnez
tripo topupà l'humain et attendez ; - avant
tripo redo, car il s'agit d'une nouvelle exécution payée avec une nouvelle graine et sans test à sec.
4. Finalisez-le dans Blender
Les deux scripts s'exécutent sans fenêtre et n'utilisent jamais le réseau.
Trouvez l'avant. La documentation de Tripo donne +x comme axe avant d'un modèle généré.
La vue de face de Blender regarde le long de +y et montre le côté qui fait face à -y, donc
tourner +x en -y est --turn -90. Tous les maillages ne suivent pas la valeur par défaut, donc
affichez d'abord le modèle brut et regardez front.png :
blender --background --factory-startup \
--python <skill-dir>/tools/preview_model.py -- \
assets/raw/statue/<model>.glb build/statue-raw --size 640
Il écrit front.png, side.png et top.png en environ deux secondes.
Finalisez-le :
blender --background --factory-startup \
--python <skill-dir>/tools/finish_model.py -- \
assets/raw/statue/<model>.glb build/statue.glb \
--height 6.5 --name statue --turn -90 --levels 0.4,0.12 --texture 1024
Le script applique chaque transformation dans les sommets, fusionne les parties en un seul
objet et supprime les sommets en double. Il tourne le modèle de --turn degrés
autour de l'axe vertical, le met à l'échelle à --height mètres, le centre et
pose son point le plus bas sur le sol. Ensuite, il réduit les textures plus longues que
--texture texels et écrit statue.glb, plus statue-1.glb et
statue-2.glb réduites à 40 % et 12 % des triangles. Sa dernière ligne,
FINISHED {...}, donne la taille, les textures réduites, et les triangles et octets de chaque
fichier. Seul --height est requis. --turn par défaut est 0, et
sans --levels ou --texture, il ne fait pas de copies et conserve les textures.
Affichez le fichier finalisé de la même manière et regardez à nouveau. S'il fait face à la mauvaise
direction, changez --turn et finalisez à nouveau à partir du fichier brut. Ne faites jamais pivoter le
fichier exporté.
Corrigez dans Blender avant de payer pour une nouvelle exécution. L'échelle, l'orientation, le pivot, le nombre de triangles, la taille de la texture, la couleur, les petites bosses et trous, et les parties fusionnées sont du travail dans Blender. Revenez à Tripo3D uniquement lorsque la forme elle-même est erronée. blender contient le tableau.
Utilisez Blender en direct pour essayer des choses, comme sculpter une main ou comparer des vues. Chaque modification qui est livrée va dans un script qui reconstruit le modèle à partir du fichier brut, car une édition manuelle ne peut pas être répétée ou révisée, et la régénération suivante la perd. Si le projet construit déjà ses modèles avec des scripts Blender, ajoutez ces étapes à cette construction au lieu de livrer la sortie de ce script.