Tripo CLI: Lassen Sie KI Text und Bilder in 3D-Modelle verwandeln

Tripo CLI ist für KI-Agenten konzipiert und macht 3D-Erstellung so einfach wie einen Chat. Ob in einem KI-Coding-Tool wie Codex, Claude Code oder Cursor oder direkt über die CLI: Eine Beschreibung in natürlicher Sprache, ein Bild oder ein vorhandenes Modell genügt, um 3D-Modelle, Animationen und andere Assets zu generieren oder umzuwandeln. Die CLI erledigt den gesamten Ablauf automatisch – Sie müssen weder APIs noch Modellversionen oder komplexe Parameter verstehen.

Soll ich die CLI oder die API verwenden?

Tripo gibt es in zwei Varianten – nehmen Sie sich zehn Sekunden, um die richtige auszuwählen:

Produkt	Am besten geeignet für	Einstieg
Tripo CLI (diese Seite)	Einsteiger: über gängige Vibe-Coding-Tools schnell auf KI-3D-Funktionen zugreifen	Einfach weiterlesen
Tripo API	Professionelle Entwickler: KI-3D-Funktionen in Websites, Apps oder eigene Geschäftssysteme integrieren	Schnellstart

Nicht sicher? Probieren Sie einfach zuerst diese Seite aus: Die Installation ist kostenlos, und Guthaben wird erst verbraucht, wenn Sie tatsächlich ein Modell generieren.

Installieren und anmelden (wählen Sie einen von zwei Wegen)

Wählen Sie einen der beiden folgenden Installationswege.

Weg eins: von der KI installieren lassen (empfohlen)

Wenn Sie bereits Cursor, Claude Code, Codex oder einen anderen KI-Assistenten verwenden, der Terminalbefehle ausführen kann, ist dies der einfachste Weg. Kopieren Sie den folgenden Prompt und senden Sie ihn vollständig an Ihren Assistenten:

Richte Tripo CLI für mich ein und erkläre jeden Schritt. Prüfe zuerst, ob Node.js 20 oder neuer installiert ist, und führe dann npm install -g tripo-cli aus. Bitte mich anschließend, tripo login im Browser abzuschließen; fordere mich nicht auf, einen API Key in den Chat einzufügen. Führe zum Schluss tripo doctor aus und teile mir mit, ob Authentifizierung, Netzwerk und Guthabenprüfung erfolgreich sind.

So geht es weiter:

Die KI prüft Ihren Computer und hilft Ihnen zuerst bei der Installation von Node.js, falls es fehlt;
Die KI führt den Installationsbefehl aus;
Jetzt sind Sie dran: Ein Browserfenster öffnet die Tripo-Anmeldeseite – melden Sie sich an und bestätigen Sie den Code, der in Ihrem Terminal angezeigt wird (diesen Schritt müssen Sie selbst erledigen; senden Sie niemals einen Key an die KI);
Die KI führt tripo doctor aus; sobald alle Prüfungen erfolgreich sind, ist die Einrichtung abgeschlossen.

Springen Sie anschließend direkt zum nächsten Abschnitt „Ihr erstes 3D-Modell erstellen“.

Probleme? Die KI kommt nicht weiter oder meldet einen Fehler

Fügen Sie die Fehlermeldung aus dem Terminal unverändert wieder in den Chat ein und lassen Sie die KI weitermachen; die meisten Probleme kann sie selbst lösen;
Anmeldung nicht abgeschlossen: Öffnen Sie die Anmeldeseite erneut und vergleichen Sie den Code sorgfältig mit dem in Ihrem Terminal, bevor Sie bestätigen;
Wenn nichts hilft, weichen Sie auf „Weg zwei: selbst installieren“ weiter unten aus – es sind nur drei Befehle.

Weg zwei: selbst installieren

Kein KI-Assistent? Kein Problem – der gesamte Vorgang besteht aus drei Befehlen.

Schritt 1: Tripo CLI installieren

Dieser Befehl installiert den Befehl tripo auf Ihrem Computer:

Bash

npm install -g tripo-cli

Normalerweise läuft der Vorgang ohne rote Fehlermeldungen durch – das bedeutet, die Installation war erfolgreich.

Probleme? npm nicht gefunden oder Berechtigungsfehler

npm nicht gefunden: Node.js ist noch nicht installiert. Installieren Sie die aktuelle LTS-Version (20 oder neuer) von der Node.js-Website, öffnen Sie das Terminal neu und versuchen Sie es erneut;
Berechtigungsfehler unter macOS (EACCES): Führen Sie stattdessen sudo npm install -g tripo-cli aus und geben Sie auf Nachfrage Ihr Computerpasswort ein;
Windows meldet, dass die Ausführung von Skripten deaktiviert ist: Öffnen Sie PowerShell erneut als Administrator und versuchen Sie es noch einmal.

Schritt 2: Bei Ihrem Tripo-Konto anmelden

Bash

tripo login

Ihr Browser öffnet automatisch eine Autorisierungsseite (registrieren Sie sich dort zuerst, falls Sie noch kein Konto haben). Die Seite zeigt einen Bestätigungscode – bestätigen Sie ihn erst, nachdem Sie geprüft haben, dass er mit dem Code in Ihrem Terminal übereinstimmt. Nach der Anmeldung bestätigt das Terminal, dass Sie angemeldet sind.

Browserseite zur Geräteautorisierung von Tripo CLI mit Bestätigungscode

Probleme? Der Browser hat sich nicht geöffnet oder die Anmeldung wurde nicht abgeschlossen

Anmeldung nicht abgeschlossen: Führen Sie tripo login erneut aus und bestätigen Sie erst, nachdem Sie den Code in Ihrem Terminal noch einmal geprüft haben;
Der Browser reagiert nicht: Kopieren Sie die im Terminal angezeigte URL von Hand in Ihren Browser;
Die Browserautorisierung ist vorübergehend nicht verfügbar: Die CLI öffnet stattdessen die API-Key-Seite – siehe „Ersatzanmeldung und Regionen“ am Ende dieses Abschnitts.

Schritt 3: Prüfen, ob alles bereit ist

Bash

tripo doctor

Der Befehl prüft nacheinander Ihren Anmeldestatus, den Netzwerkzugriff und Ihr Guthaben. Sind alle drei Prüfungen erfolgreich, ist die Einrichtung abgeschlossen.

Probleme? Eine der Prüfungen ist fehlgeschlagen

Authentifizierung fehlgeschlagen: Die Anmeldung wurde nicht abgeschlossen – führen Sie tripo login aus und melden Sie sich erneut an;
Netzwerk fehlgeschlagen: Prüfen Sie, ob Ihr Computer Webseiten öffnen kann; Firmen- oder Campus-Netzwerke benötigen eventuell einen Proxy;
Guthabenprüfung fehlgeschlagen: Ihr Guthaben reicht nicht aus; es wurde noch nichts generiert und nichts berechnet. Führen Sie tripo topup aus, um die Abrechnungsseite zu öffnen.

Ersatzanmeldung und Regionen (nur falls die Browser-Anmeldung nicht verfügbar ist)

Wenn Sie bereits einen API-Key haben, führen Sie tripo login --key tsk_... aus oder setzen Sie die Umgebungsvariable TRIPO_API_KEY;
Ein API-Key ist ein Zugangsschlüssel zu Ihrem Konto: Fügen Sie ihn niemals in Chats, Quellcode, Screenshots oder Logs ein;
Dieselbe Installation funktioniert für internationale Konten und für Konten in Festlandchina: Die CLI prüft mit Ihrem Key beide Regionen und speichert die akzeptierte Region automatisch.

Ihr erstes 3D-Modell erstellen

Schritt 1: Aus einem Satz generieren

Die Wörter in den Anführungszeichen sind Ihr Prompt – ersetzen Sie sie durch das, was Sie erstellen möchten:

Bash

tripo make "a cute low poly fox"

Lassen Sie das Terminal geöffnet, während der Befehl läuft. Tripo CLI wählt den passenden Ablauf und das passende Modell, wartet auf den Abschluss der Aufgabe und lädt die Dateien in einen Ordner tripo-out im aktuellen Verzeichnis herunter. Der gesamte Durchlauf ist meist innerhalb weniger Minuten abgeschlossen und kostet nur wenig Guthaben.

Probleme? Die Generierung startet nicht oder bricht mittendrin ab

Unzureichendes Guthaben: Die Generierung Ihres Modells hat noch nicht begonnen, und es wurde nichts berechnet. Führen Sie tripo topup aus, um Guthaben aufzuladen, und versuchen Sie es dann erneut;
Netzwerkfehler: Stellen Sie sicher, dass Ihr Computer online ist, und führen Sie denselben Befehl noch einmal aus;
Aufgabe fehlgeschlagen: Bereits berechnetes Guthaben wird automatisch zurückerstattet – versuchen Sie es mit einer anderen Beschreibung.

Schritt 2: Die Vorschau öffnen

Bash

tripo view @last

@last bedeutet „die letzte Aufgabe“. Ihr Browser öffnet eine interaktive 3D-Vorschau, die Sie durch Ziehen drehen können – sobald Sie Ihr Modell sehen, haben Sie es geschafft!

Nach dem ersten Erfolg: Das haben Sie jetzt

Wo die Dateien liegen: Ein neuer Ordner unter tripo-out enthält das heruntergeladene 3D-Modell und die Datei task.json, die festhält, wie die Aufgabe erstellt wurde; liefert der Server ein Vorschaubild, erhalten Sie zusätzlich preview.png.
Erneut öffnen: Führen Sie jederzeit tripo view @last aus, oder öffnen Sie mit tripo view <file> eine beliebige Modelldatei.
Was es gekostet hat: Führen Sie tripo balance aus, um Ihr Guthaben zu prüfen.
Keine Lust, sich Befehle zu merken? Führen Sie einfach tripo aus, um ein geführtes interaktives Menü zu öffnen – Anmeldung, Generierung, Vorschau und Aufladen finden Sie alle dort.
Nächste Schritte: Generieren Sie aus Bildern (nächster Abschnitt), lassen Sie einen KI-Assistenten die Arbeit übernehmen („KI-Coding-Agenten die CLI meistern lassen“) oder verarbeiten Sie viele Modelle auf einmal („Fertige Workflows und Pipelines“).

Aus einem Bild oder einem vorhandenen Modell generieren

Sobald das Textbeispiel funktioniert, können Sie stattdessen lokale Dateien übergeben. concept.png, front.png und hero.glb unten sind Beispielnamen – ersetzen Sie sie durch Ihre eigenen Dateipfade:

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

Zeile 1: Ein Konzeptbild in ein druckfertiges Modell verwandeln;
Zeile 2: Aus Vorder- und Rückansicht gemeinsam generieren, für genauere Details;
Zeile 3: Ein vorhandenes Modell texturieren und riggen;
Zeile 4: Das letzte Ergebnis nach FBX konvertieren.

KI-Coding-Agenten die CLI meistern lassen

Wenn Sie keinen KI-Coding-Agenten verwenden, können Sie diesen Abschnitt überspringen. Das npm-Paket enthält einen Agent Skill – Befehlsreferenzen, Szenario-Rezepte und Anleitungen zur Fehlerbehebung –, damit ein Agent die CLI korrekt verwenden kann. Lassen Sie den Agenten diese Befehle ausführen, um die vollständigen Anweisungen oder ein einzelnes Thema im Terminal auszugeben:

Bash

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

Im Skill enthaltene Dateien

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

Befehlsreferenz

Sie müssen diese Tabelle nicht auswendig lernen: Im Alltag brauchen Einsteiger nur tripo (interaktives Menü), tripo make (generieren), tripo view (Vorschau) und tripo doctor (Systemprüfung). Klappen Sie den Rest nur auf, wenn ein konkreter Bedarf entsteht.

Vollständige Befehlstabelle und häufige Optionen anzeigen

Befehl	Funktion
`tripo make <input...>`	Mit einem Befehl generieren, verarbeiten und herunterladen
`tripo ai [description]`	Einen Auftrag planen, bestätigen und ausführen
`tripo view [task\|file]`	Eine interaktive lokale 3D-Vorschau öffnen
`tripo redo [task]`	Eine Anfrage mit einem neuen Seed wiederholen
`tripo login / logout / whoami / use`	Autorisieren und zwischen benannten Kontoprofilen wechseln
`tripo topup / balance / usage`	Die regionale Abrechnung öffnen und Guthaben prüfen
`tripo generate <endpoint>`	Alle acht Generierungsendpunkte explizit verwenden
`tripo model / anim / mesh <step>`	Verfeinerung, Texturierung, Rigging, Konvertierung, Segmentierung und weitere Verarbeitungsschritte ausführen
`tripo task get/list/watch`	Aufgaben abfragen, auflisten oder auf sie warten
`tripo history [--limit <n>]`	Den lokalen Verlauf der letzten Aufgaben anzeigen
`tripo files upload <path>`	Eine Datei hochladen und ihr `file_token` zurückgeben
`tripo batch run <manifest.yaml>`	Fortsetzbare Massen-Pipelines mit Parallelität und Wiederholungsversuchen ausführen
`tripo config / doctor`	Einstellungen verwalten und die lokale Umgebung diagnostizieren
`tripo docs [--topic <topic>]`	Die mitgelieferte Agent- und Befehlsdokumentation ausgeben
`tripo mcp`	Die CLI als MCP-Server ausführen
`tripo completion <shell>`	Shell-Vervollständigung für Bash, Zsh oder Fish erzeugen

Die Befehle make, ai und generate sowie die Verarbeitungsunterbefehle unter model, anim und mesh unterstützen -o/--out, --no-wait, --no-download, --name, --timeout, --notify und das wiederholbare --param key=value. Zu den globalen Automatisierungsoptionen gehören --json, --yes, --quiet, --no-open und --profile.

Fertige Workflows und Pipelines

Dies ist ein Abschnitt für Fortgeschrittene; für Ihre erste Generierung brauchen Sie ihn nicht. Sieben integrierte Voreinstellungen wenden über --for <preset> nützliche Parameter und Verarbeitungsschritte auf einmal an:

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

Aufgabenreferenzen wie @last, @2 und @name funktionieren überall dort, wo eine Aufgaben-ID akzeptiert wird.

Mehrere Konten und Regionen

Wenn Sie nur ein Tripo-Konto verwenden, können Sie diesen Abschnitt überspringen. Anmeldedaten werden in benannten Profilen gespeichert, sodass die Anmeldung bei einem zweiten Konto das erste nicht überschreibt:

Bash

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

Jedes Profil verwaltet seinen eigenen Key und seine eigene Region. Die Umgebungsvariable TRIPO_PROFILE wählt ein Profil für die aktuelle Umgebung aus, während TRIPO_API_KEY alle Profile umgeht und die höchste Priorität hat.

Hinweise für KI-Coding-Agenten

Normale Benutzer können diesen Abschnitt überspringen. Diese Regeln helfen KI-Coding-Agenten, korrekt auf Aufgaben zu warten und maschinenlesbare Ausgaben zu verarbeiten.

tripo make und tripo task watch sind blockierende Befehle. Warten Sie, bis der Prozess abgeschlossen ist, anstatt eine weitere Abfrageschleife zu implementieren.
Mit --json schreiben die meisten einmalig ausgeführten Befehle eine abschließende JSON-Zeile nach stdout. tripo task watch --json streamt stattdessen NDJSON-Fortschrittsereignisse und anschließend das Endergebnis.
Falls preview.png vorhanden ist, prüfen Sie die Datei, bevor Sie entscheiden, ob Sie eine Pipeline fortsetzen oder tripo redo ausführen.
Erfinden Sie keine Parameter und erzwingen Sie keine veralteten Modellversionen. Verwenden Sie tripo docs --topic ..., um die unterstützten Optionen abzurufen.
Bei einer Low-Poly-Anfrage oder einem Flächenbudget von höchstens 20.000 wird tripo-p1 ausgewählt; für andere Aufgaben wird standardmäßig tripo-v3.1 verwendet.

Exit-Code-Tabelle anzeigen

Exit-Code	Bedeutung
`0`	Erfolg
`1`	Unerwarteter oder interner Fehler
`2`	Ungültige Verwendung oder Parameter
`3`	Authentifizierungsfehler
`4`	Unzureichendes Guthaben
`5`	Ablehnung aufgrund der Inhaltsrichtlinie
`6`	Aufgabe fehlgeschlagen; Guthaben wird automatisch zurückerstattet
`7`	Netzwerkfehler
`8`	Ressource nicht gefunden
`9`	Ratenbegrenzung erreicht; mit Backoff erneut versuchen

Umgebungsvariablen für Automatisierung

Für die normale interaktive Nutzung sind keine Umgebungsvariablen erforderlich; sie sind für CI, Skripte und fortgeschrittene Agent-Workflows gedacht. Denken Sie daran: Übertragen Sie niemals einen API-Key in ein Repository, fügen Sie ihn nicht in Dokumentationen ein und zeigen Sie ihn nicht in Screenshots oder Logs.

Tabelle der Umgebungsvariablen anzeigen

Variable	Zweck
`TRIPO_API_KEY`	API-Key; höchste Priorität und für CI oder Agenten geeignet
`TRIPO_PROFILE`	Benanntes Kontoprofil, entspricht `--profile`
`TRIPO_REGION`	Optionale Überschreibung mit `ov` oder `cn`; wird normalerweise automatisch erkannt
`TRIPO_API_BASE_URL`	Überschreibung des API-Endpunkts
`TRIPO_PLATFORM_BASE_URL`	Überschreibung des Plattform-Endpunkts
`TRIPO_HOME`	Konfigurations- und Verlaufsverzeichnis; standardmäßig `~/.tripo`
`TRIPO_LLM_BASE_URL`	Optionaler OpenAI-kompatibler Endpunkt für `tripo ai`
`TRIPO_LLM_API_KEY`	Optionaler LLM-Key für `tripo ai`
`TRIPO_LLM_MODEL`	Optionales LLM-Modell für `tripo ai`