CommunityBildgithub.com

tripo3d-blender

Bild-Skill. Erstelle 3D-Modelle mit Tripo3D und verfeinere sie in Blender. Tripo3D generiert das Basisnetz aus einem Prompt oder einem Bild, und jede Feinabstimmung erfolgt in Blender, headless oder live, wie Größe, Ausrichtung, Drehpunkt, Bereinigung, skulpturale Korrekturen, Neubemalung, Texturgröße, Detailstufen und GLB-Export. Verwende dies, wenn aufgefordert wird, ein 3D-Modell, eine Statue, einen Gegenstand, ein Gebäude, einen Felsen, einen Charakter oder ein Game-Asset aus Text oder einem Bild zu generieren oder zu erstellen, oder eines, das Konzeptkunst oder einem Foto entsprechen muss, einschließlich der Erstellung und Überprüfung der Eingabebilder.

Was ist tripo3d-blender?

Dieses Skill integriert Tripo3D und Blender, um 3D-Modelle effizient zu erstellen und zu verfeinern. Tripo3D generiert schnell ein texturiertes Basisnetz aus einem Bild oder Prompt, was jedoch Kredite kostet und grobe Kontrollen bietet. Blender übernimmt dann die präzise Nachbearbeitung, einschließlich Skalierung, Ausrichtung, Texturverkleinerung und Erstellung mehrerer Detailstufen (LODs). Der Workflow vermeidet unnötige Neuberechnungen bei Tripo3D: Nur wenn die Grundform falsch ist, wird ein neuer Durchlauf bezahlt; alle anderen Anpassungen erfolgen in Blender mit reproduzierbaren Skripten. Das Skill unterstützt macOS, Linux und Windows (mit Einschränkungen) und erfordert eine kostenpflichtige Tripo3D-API, Blender 5.x sowie Node.js 20 oder höher. Es nutzt das offizielle `tripo-cli`-Tool für alle Tripo-Aufrufe und Blender-Skripte (`preview_model.py`, `finish_model.py`) für die Bearbeitung. Der gesamte Prozess ist dokumentiert und getestet für reproduzierbare Ergebnisse, die in GLB exportiert werden.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Tripo3D-Modelle, fertiggestellt in Blender

Tripo3D verwandelt ein Bild oder einen Prompt in etwa einer Minute in ein texturiertes Netz. Jeder Durchlauf kostet Credits, die Steuerungsmöglichkeiten sind grob, und eine neue Modellversion liefert für dieselbe Anfrage ein anderes Netz. Blender ist kostenlos und exakt, und ein Skript liefert jedes Mal das gleiche Ergebnis. Nimm also das Basisnetz von Tripo3D einmal, behalte es und nimm jede Verfeinerung in Blender vor. Bezahle einen neuen Durchlauf nur, wenn die Form falsch ist. Größe, Ausrichtung, eine klumpige Hand, ein Texturton und ein Dreiecksbudget sind alles Blender-Korrekturen.

Getestet am 20.11.2026 mit tripo-cli 0.11.2, Blender 5.3.0 und Node 24 auf macOS. Wenn tripo --version eine neuere Version ausgibt, vertraue tripo docs --topic commands/make mehr als dieser Datei für Flags.

Referenzdateien

Diese Datei führt ein Modell vom Setup bis zum fertigen GLB. Öffne eine Referenz nur, wenn die Aufgabe deren Detail benötigt.

ReferenzÖffne sie, wenn duZeilen
Setupinstallierst oder anmeldest, den MCP-Server hinzufügst, unter Linux arbeitest oder von einem anderen Tripo-Weg versucht bist146
Bilderdie Eingabebilder für ein Modell erstellst, das einem Zielbild entsprechen muss, und sie überprüfen lässt123
Generierungein Modell oder Parameter auswählst, mehrere Bilder verwendest, Tripos eigene Schritte verkettest oder Credits zählst146
Blenderein generiertes Modell korrigierst, in einem Live-Blender arbeitest oder diese Schritte in den Build eines Projekts einfügst283
Fehlerden Exit-Code eines fehlgeschlagenen Befehls oder einen Blender-Skriptfehler liest43

Die beiden Skripte, die diese Datei ausführt, befinden sich in tools/ neben ihr. Unten bezeichnet <skill-dir> den Ordner, der diese SKILL.md enthält.

1. Was ein Mensch zuerst tun muss

Ein Agent kann diese Schritte nicht ausführen. Frage danach, bevor du irgendetwas ausführst.

  1. Ein kostenpflichtiges Tripo3D-API-Konto unter https://developers.tripo3d.ai (international) oder https://developers.tripo3d.com (China-Festland). API- Credits sind getrennt von Tripo Studio-Credits. Bezahlt ist wichtig für Rechte: Tripos Bedingungen geben zahlenden Nutzern die Rechte an ihren Ausgaben, einschließlich Veröffentlichung und Verkauf (Abschnitt 5.2.2), und behalten die Ausgaben kostenloser Nutzer für Tripo (Abschnitt 5.2.1).

  2. Der API-Schlüssel im System-Geheimnisspeicher. Auf macOS führt der Mensch dies aus und gibt den Schlüssel an der Eingabeaufforderung ein, sodass der Schlüssel nie durch den Chat geht:

    security add-generic-password -a "$USER" -s tripo3d-api-key -w
    

    Ohne Schlüssel funktioniert auch die Browser-Anmeldung in Setup.

  3. Blender 5.x mit blender im Pfad. Für Live-Steuerung wird auch das Blender Lab MCP-Add-on mit aktiviertem Allow Online Access benötigt; siehe Blender.

Frage niemals nach dem Schlüssel im Chat und schreibe ihn niemals in eine von dir erstellte Datei. Lies ihn inline aus dem Geheimnisspeicher aus, wie Abschnitt 2 es tut.

2. Tripo3D einrichten

Einmal pro Maschine:

node --version                      # benötigt 20 oder höher
npm install -g tripo-cli            # installiert den Befehl `tripo`
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
  2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<hidden>/g'
tripo doctor                        # jeder Check "ok": true

tripo login --key versucht beide Regionen, behält diejenige, die den Schlüssel akzeptiert und speichert ihn in ~/.tripo/config.json mit Modus 0600, sodass kein späterer Befehl den Schlüssel benötigt. Ein Nullsaldo in tripo doctor ist eine Warnung, kein Fehler.

Verwende tripo-cli, Tripos offizielles Tool, für jeden Tripo-Aufruf. Der ältere Tripo-Developer/tripo-mcp-Server stürzt beim Start ab und treibt ein Blender-Add-on an, das nicht mehr existiert. Das Tripo Bridge-Add-on in Blender akzeptiert nur Modelle, die eine Person von der Tripo-Website sendet. Setup enthält die Details.

3. Ein Basismodell generieren

Wähle die Eingabe. Ein Bild des gesamten Objekts, allein, auf einfarbigem Hintergrund, in einer Vorder- oder Dreiviertelansicht. Zwei bis vier Bilder decken die verborgenen Seiten ab; benenne die Dateien front, left, back und right. Das Modell kopiert die Form, Oberfläche und Farbe des Bildes, daher müssen Abnutzung, Moos und Farbe im Bild sein. Ein in Anführungszeichen gesetzter Prompt funktioniert ebenfalls, mit weniger Kontrolle.

Lasse die Bilder überprüfen, bevor du bezahlst. Ein Fehler im Bild taucht im Netz wieder auf, und ein neuer Durchlauf kostet erneut die Credits. Wenn der Mensch ein Ziel vorgibt, wie Konzeptkunst oder ein Foto, und das Modell diesem entsprechen soll:

  1. schreibe eine Checkliste allein aus dem Ziel: was jeder Teil zeigt, was fehlschlägt, und Verhältnisse und Farben, die gemessen werden können;
  2. erstelle zwei bis acht neue Kandidaten für jede Ansicht, zuerst die Vorderseite, und die anderen Ansichten aus der übergebenen Vorderseite;
  3. gib das Ziel, die Checkliste und die Kandidaten einem separaten Prüfer, einem anderen Agenten oder einer Person, die sie nicht erstellt hat, dessen Aufgabe es ist, sie durchfallen zu lassen;
  4. führe Tripo3D nur mit Bildern aus, die bestanden haben, und notiere die Punkte, die der Prüfer durchgelassen hat, für den Blender-Abschluss.

Bilder enthält die Schleife, wie der Prüfer eingewiesen wird, was ein Bild durchfallen lässt und wie eines gemessen wird.

Wähle das Modell. Ohne --model verwendet jeder Durchlauf P2, das etwa dreimal so viel kostet wie H3.1.

ModellFlagTrockenlauf-SchätzungVerwende es für
H3.1--model tripo-v3.110 bis 50 Credits; ein Bild mit detaillierten PBR-Karten ist 40Detaillierte feste Objekte: Statuen, Requisiten, Felsen
P2 (Standard)--model tripo-p2100 bis 130 Credits; ein einfaches Bild ist 110Saubere Low-Poly-Topologie, Vierecke

Führe einen Trockenlauf durch. Ein Trockenlauf sendet nichts und verbraucht nichts:

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 muss true sein und errors leer. Jeder Eintrag in warnings ist eine Einstellung, die die CLI entfernt hat, sodass diese Anforderung nicht erfüllt wird; kläre sie vor dem Bezahlen. generation_credits_estimate ist der Listenpreis der Generierung allein.

Führe es aus ohne --dry-run. Der Befehl blockiert, bis das Modell, preview.png und task.json im Ordner -o sind, und gibt dann eine JSON-Zeile aus. Nimm den Pfad des Modells aus seinem Feld model_file, da sich der Dateiname mit den Optionen ändert (pbr_model.glb zum Beispiel). Sieh dir preview.png an, bevor du fortfährst.

Behalte das Rohergebnis. Download-Links laufen nach etwa fünf Minuten ab, und eine spätere Modellversion liefert ein anderes Netz vom selben Seed, daher sind die heruntergeladenen Dateien die einzige Kopie:

mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/    # model, task.json, preview.png

Commite diesen Ordner oder behalte ihn bei den Quell-Assets des Projekts. Jeder Blender- Schritt liest diese Kopie und niemals das Netzwerk, sodass ein Neubau die gleichen Dateien liefert.

Halte inne und frage den Menschen:

  • vor jedem Durchlauf, der auf mehr als 50 Credits geschätzt wird, jedem P2-Durchlauf und jeder Charge, deren Schätzungen sich auf mehr als 150 Credits summieren;
  • nach Exit-Code 4, nicht genügend Credits, da jeder erneute Versuch auf die gleiche Weise fehlschlägt: gib dem Menschen tripo topup und warte;
  • vor tripo redo, da es ein neuer bezahlter Durchlauf mit einem neuen Seed und ohne Trockenlauf ist.

4. Fertigstellung in Blender

Beide Skripte laufen ohne Fenster und verwenden niemals das Netzwerk.

Finde die Vorderseite. Tripos Dokumentation gibt +x als Vorwärtsachse eines generierten Modells an. Blenders Vorderansicht blickt entlang +y und zeigt die Seite, die -y zugewandt ist, also ist das Drehen von +x zu -y --turn -90. Nicht jedes Netz folgt der Voreinstellung, also rendere das rohe Modell zuerst und sieh dir front.png an:

blender --background --factory-startup \
  --python <skill-dir>/tools/preview_model.py -- \
  assets/raw/statue/<model>.glb build/statue-raw --size 640

Es schreibt front.png, side.png und top.png in etwa zwei Sekunden.

Stelle es fertig:

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

Das Skript bäckt jede Transformation in die Vertices ein, verbindet die Teile zu einem Objekt und führt doppelte Vertices zusammen. Es dreht das Modell um --turn Grad um die vertikale Achse, skaliert es auf --height Meter, zentriert es und stellt seinen tiefsten Punkt auf den Boden. Dann verkleinert es Texturen, die länger als --texture Texel sind, und schreibt statue.glb, plus statue-1.glb und statue-2.glb, reduziert auf 40% und 12% der Dreiecke. Seine letzte Zeile, FINISHED {...}, gibt die Größe, die verkleinerten Texturen und die Dreiecke und Bytes jeder Datei an. Nur --height ist erforderlich. --turn ist standardmäßig 0, und ohne --levels oder --texture erstellt es keine Kopien und behält die Texturen.

Rendere die fertige Datei auf die gleiche Weise und sieh noch einmal nach. Wenn sie in die falsche Richtung zeigt, ändere --turn und stelle sie erneut aus der Rohdatei fertig. Drehe niemals die exportierte Datei.

Korrigiere in Blender, bevor du für einen neuen Durchlauf bezahlst. Skalierung, Ausrichtung, Drehpunkt, Dreiecksanzahl, Texturgröße, Farbe, kleine Höcker und Löcher sowie verschmolzene Teile sind Blender-Arbeit. Gehe nur dann zurück zu Tripo3D, wenn die Form selbst falsch ist. Blender enthält die Tabelle.

Verwende Live-Blender zum Ausprobieren, wie das Modellieren einer Hand oder den Vergleich von Ansichten. Jede Änderung, die ausgeliefert wird, geht in ein Skript, das das Modell aus der Rohdatei neubaut, da eine manuelle Bearbeitung nicht wiederholt oder überprüft werden kann und die nächste Regenerierung sie verliert. Wenn das Projekt seine Modelle bereits mit Blender-Skripten baut, füge diese Schritte zu diesem Build hinzu, anstatt die Ausgabe dieses Skripts auszuliefern.

Verwandte Skills