CommunityImagegithub.com

tripo3d-blender

Créez des modèles 3D avec Tripo3D et peaufinez-les dans Blender. Tripo3D génère le maillage de base à partir d'une invite ou d'une image, et chaque raffinement précis se fait dans Blender, en mode headless ou en direct : taille, orientation, pivot, nettoyage, corrections sculptées, repeinture, taille de texture, niveaux de détail et exportation GLB.

Qu'est-ce que tripo3d-blender ?

Cette compétence permet à un agent IA de générer des modèles 3D texturés à l'aide de Tripo3D, puis de les peaufiner de manière fiable et reproductible dans Blender. Elle est particulièrement utile pour créer des actifs 3D (statues, accessoires, bâtiments, rochers, personnages, éléments de jeu) à partir de texte ou d'images, avec un contrôle précis sur la taille, l'orientation, le pivot, la propreté du maillage et les niveaux de détail. La compétence prend en charge l'utilisation de l'outil en ligne de commande `tripo-cli` de Tripo3D (à ne pas confondre avec l'ancien serveur MCP qui ne fonctionne plus) et Blender headless via des scripts Python dédiés. Elle fonctionne sur macOS et Linux (avec des détails dans les fichiers de référence). Le flux de travail est le suivant : l'agent demande d'abord les prérequis humains (clé API payante, Blender 5.x, installation de tripo-cli), puis l'utilisateur fournit une ou plusieurs images de référence. L'agent génère le modèle de base avec Tripo3D (en choisissant entre les modèles H3.1 pour les objets détaillés ou P2 pour une topologie propre). Ensuite, il exécute des scripts Blender pour redimensionner, orienter, centrer, fusionner les parties, réduire les textures et créer plusieurs niveaux de détail (LOD) pour l'exportation GLB. L'accent est mis sur la minimisation des coûts en n'utilisant Tripo3D qu'une seule fois, toutes les corrections ultérieures étant effectuées dans Blender. L'agent ne doit jamais demander la clé API dans le chat, mais la lire depuis le trousseau système.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hiddentao/tripo3d-blender-skill/tree/HEAD/tripo3d-blender

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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érenceOuvrez-la lorsque vousLignes
configurationinstallez ou connectez-vous, ajoutez le serveur MCP, travaillez sous Linux, ou êtes tenté par une autre route Tripo146
imagescréez les images d'entrée pour un modèle qui doit correspondre à une image cible, et les faites réviser123
générationchoisissez un modèle ou des paramètres, utilisez plusieurs images, enchaînez les propres étapes de Tripo, ou comptez les crédits146
blendercorrigez un modèle généré, travaillez dans un Blender en direct, ou intégrez ces étapes dans la construction d'un projet283
erreurslisez le code de sortie d'une commande ayant échoué, ou une erreur de script Blender43

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.

  1. 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).

  2. 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 -w
    

    Sans clé, la connexion par navigateur dans configuration fonctionne aussi.

  3. Blender 5.x, avec blender dans 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 :

  1. 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 ;
  2. créez deux à huit nouvelles images candidates pour chaque vue, d'abord la face, puis les autres vues à partir de la face réussie ;
  3. 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 ;
  4. 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èleIndicateurEstimation à secUtilisez-le pour
H3.1--model tripo-v3.110 à 50 crédits ; une image avec des cartes PBR détaillées est de 40Objets solides détaillés : statues, accessoires, rochers
P2 (par défaut)--model tripo-p2100 à 130 crédits ; une image simple est de 110Topologie 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.

Skills associés