Blog

Benutzerhandbuch

Tripo H3.1 Einstiegsleitfaden: Drei Eingabewege, Parameter und Preiswahl

Praktische Entscheidungsfindung und Kostenkontrolle bei der 3D-Generierungsintegration für Entwickler

Nov 20, 2026
Abstrakte Cover-Abbildung einer geometrischen Betonfläche unter streifendem Licht, grauer Grund mit schieferblauen Schatten und schmalen salbeigrünen Fugen.
Auf dieser Seite

Was Tripo H3.1 leistet und wo die Grenzen liegen

Tripo H3.1 ist ein 3D-Generierungsmodell, das unter der einheitlichen Schnittstelle von HiAPI.ai läuft und sich mit einem einzigen API-Schlüssel aufrufen lässt. Es unterstützt drei Eingabeformen: natürlichsprachliche Beschreibung (Text-zu-3D), ein einzelnes Objektbild (Bild-zu-3D) sowie 2–4 Multi-View-Bilder desselben Objekts (Multi-View-zu-3D).

Die Ausgabe ist ein festes Lieferpaket: eine GLB-Modell-Datei + ein Vorschaubild. Es gibt kein zusätzliches Materialtexturpaket, keine Projektdateien, kein Rigging und keine Animation. GLB ist ein universelles Format; man kann es direkt in Blender, Three.js, Unity oder jede beliebige glTF-fähige Pipeline übernehmen.

Auch die Grenzen müssen klar benannt werden:

  • Es ist objektbezogene Generierung, keine szenenbezogene. Wenn man ein Bild eines Stuhls eingibt, erhält man einen Stuhl, keinen Raum mit einem Stuhl darin. Für Szenen muss man mehrere Modelle selbst kombinieren.
  • Es versteht keine „Bewegung“. Statische Assets sind seine Komfortzone; Rigging, Skinming und Bewegungssequenzen liegen außerhalb des Leistungsumfangs.
  • Die Materialqualität ist die Obergrenze der Ausgabe. Unscharfe Eingabebilder mit mehreren Objekten oder komplexen Verdeckungen senken die Geometriequalität deutlich – das gilt auf allen drei Wegen.
  • Die Abrechnung erfolgt pro Aufruf, ein Aufruf erzeugt ein Modell, es gibt keinen Zwischenzustand nach Token oder Sekunde. Diese Eigenschaft ist für die Kostenschätzung günstig – die Anzahl der Aufrufe ist die Abrechnungseinheit.

Erst mit diesem Verständnis des Umfangs ergeben die folgenden Entscheidungen Sinn: Die drei Wege sind nicht drei Zugänge zum selben Ding, ihre Stückpreise, Materialvoraussetzungen und Einsatzszenarien unterscheiden sich.

Drei Eingaben werden durch denselben Trichter zu einem einzigen Modell und einer Vorschauausgabe zusammengeführt; an der Verengung zeigen sich auch die Grenzen.

Wie man den passenden Eingabeweg wählt

Das erste Prinzip bei der Wahl des Weges ist nicht „welcher liefert das beste Ergebnis“, sondern über welches Material Sie verfügen.

Nur eine Textbeschreibung → Text-zu-3D. Geeignet für Konzeptexploration, Platzhalter-Assets und frühe Prototypen. Sie kontrollieren die Generierungsrichtung vollständig, tragen aber auch die gesamte Unsicherheit: Die Ableitung von Flächenanzahl und Form durch das Modell stammt ausschließlich aus Ihren Beschreibungswörtern. Die Einstiegsstufe ist am niedrigsten und eignet sich für umfangreiches Ausprobieren.

Ein sauberes Produktbild oder Objektfoto → Bild-zu-3D. Dies ist der Weg, den die überwiegende Mehrheit der Entwickler tatsächlich geht. Ein Bild frontal auf das Objekt mit sauberem Hintergrund enthält deutlich mehr Information als eine Textbeschreibung, und die geometrische Wiedergabetreue ist deutlich stabiler. Die Materialhürde ist auch nicht hoch: ein Foto machen, den Hintergrund freistellen, fertig.

2–4 Bilder aus unterschiedlichen Winkeln → Multi-View-zu-3D. Wenn Sie bereits Material aus mehreren Winkeln haben (etwa die standardmäßigen vier Ansichten aus einem Produktfotostudio oder Turntable-Frames, die aus einem vorhandenen 3D-Asset gerendert wurden), ist Multi-View die Stufe mit der höchsten Präzisionsgrenze. Es löst das strukturelle Problem der Einzelbildgenerierung, dass die Rückseite „geraten“ werden muss.

Eine erwähnenswerte Preistatsache: Bild-zu-3D und Multi-View kosten gleich viel, Text-zu-3D ist günstiger. Bei vollständigem Material gibt es für Multi-View also keinen Aufpreis – wenn Material vorhanden ist, nutzen Sie Multi-View, es gibt keinen Grund, auf das Einzelbild zurückzugreifen.

Die Entscheidung lässt sich auf einen Satz vereinfachen: Genug Material für Multi-View → Multi-View; ein gutes Bild → Bild-zu-3D; gar nichts → Text-zu-3D.

Eingabeparameter und Punkte zur Materialvorbereitung

Die Eingabefelder der drei Wege unterscheiden sich; eine Vermischung führt direkt zum Fehlschlag.

Text-zu-3D (Modellseite) nimmt natürlichsprachliche Beschreibungen entgegen. Der Kern eines guten Prompts ist Konkretheit: Objekttyp, Materialtendenz, Formmerkmale sind wirksamer als eine Anhäufung von Adjektiven.

Bild-zu-3D (Modellseite) verwendet image_url, ein HTTPS-Bild. Anforderungen an das Material:

  • Ein einzelnes Objekt, keine mehreren Objekte im selben Bild
  • Sauberer Hintergrund, keine unruhige Umgebung in derselben Farbe wie das Motiv
  • Das Objekt sollte das Bild möglichst ausfüllen
  • Die URL muss öffentlich zugänglich sein (HTTPS); keine privaten Adressen mit Authentifizierung übermitteln

Multi-View-zu-3D (Modellseite) verwendet image_urls, 2–4 Bilder desselben Objekts, die Reihenfolge ist fest vorgegeben: vorne, links, hinten, rechts. Eine falsche Reihenfolge ist eine der häufigsten Fehlerquellen: Das Modell nimmt die Perspektive anhand der Position an, ein falsch platziertes Bild bedeutet also eine falsche geometrische Vorgabe.

Zur Materialvorbereitung gibt es zwei allgemeine Empfehlungen. Erstens sollten die mehreren Multi-View-Bilder möglichst dieselbe Beleuchtung und Maßstäblichkeit aufweisen; die Mischung von Fotos aus verschiedenen Quellen führt zu Mehrdeutigkeiten an den Nahtstellen des Modells. Zweitens muss die Bildauflösung nicht extrem hoch sein; Klarheit und ein eindeutiges Motiv sind wichtiger als die Pixelzahl.

Anfragen mit ungültigen Parametern (fehlende Felder, falsches URL-Format, Ansichtenanzahl außerhalb des Bereichs) werden direkt abgelehnt und nicht berechnet – das wird in der Fehlersuche-Checkliste im nächsten Abschnitt noch verwendet.

face_limit und Geometriequalität: die Modellkomplexität steuern

face_limit ist der zentrale Parameter zur Steuerung der Ausgabeflächenanzahl, der Wertebereich ist 1000–1.500.000; wenn geometry_quality auf detailed gesetzt ist, erweitert sich die Obergrenze auf 2.000.000.

Das entscheidende Design ist: Dieser Parameter kann weggelassen werden. Wird er weggelassen, entscheidet das Modell adaptiv über die Flächenanzahl und gibt in der Regel einen sinnvollen, zur Objektkomplexität passenden Wert aus. Nur wenn Sie das Flächenbudget der nachgelagerten Stufe genau kennen, müssen Sie ihn manuell angeben:

  • Echtzeit-Rendering auf Mobilgerät oder Web: niedrigere Stufe, innerhalb von einigen zehntausend Flächen halten
  • Mitteldistanz-Assets in Spielen: mittlere Stufe
  • Film- und Fernsehqualität oder Offline-Rendering: nahe der Obergrenze, zusammen mit feiner Geometrie

geometry_quality hat zwei Werte: standard (Standardgeometrie, Standard) und detailed (feine Geometrie). detailed bringt höhere geometrische Details und eine höhere Flächenobergrenze, ist aber eine Option mit Aufpreis, und zwar auf allen drei Wegen. Das Beurteilungskriterium ist direkt: Nur wenn das Asset aus der Nähe betrachtet wird oder die Details selbst das Verkaufsargument sind, lohnt es sich; detailed für ein Fernsicht- oder Platzhalter-Asset zu aktivieren, ist reine Verschwendung.

Praktische Empfehlung für das Zusammenspiel: Führen Sie zuerst eine Version mit der Standardkonfiguration aus (also face_limit weglassen und geometry_quality auf standard), prüfen Sie das Ergebnis und justieren Sie dann die Parameter für das konkrete Asset. Fahren Sie nicht sofort alle Parameter auf Anschlag – das kostet mehr und liefert nicht unbedingt bessere Ergebnisse.

Aufschlüsselung der Preisstruktur: In welcher Stufe das Geld landet

Tripo H3.1 wird pro Aufruf abgerechnet, jeder Aufruf erzeugt Modell + Vorschaubild. Der Preis wird von vier Variablen gemeinsam bestimmt: Eingabeweg, Texture-Schalter, PBR-Schalter, Geometriequalität. Nachdem Sie diese Struktur verstanden haben, wählen Sie anhand der nachfolgenden vollständigen Listenpreise die passende Stufe.

Die aktuellen Listenpreise in der Testumgebung lauten wie folgt, pro Aufruf und pro Modell, in USD.

Text-zu-3D (tripo-h3.1/text-to-3d)

SpezifikationStandardtexturFeine Textur
PBR aus · Texture aus$0,150$0,150
PBR aus · Texture an$0,290$0,430
PBR an$0,290$0,430

Bild-zu-3D (tripo-h3.1/image-to-3d) und Multi-View-zu-3D (tripo-h3.1/multiview-to-3d) zum gleichen Preis

SpezifikationStandardtexturFeine Textur
PBR aus · Texture aus$0,290$0,290
PBR aus · Texture an$0,430$0,580
PBR an$0,430$0,580

Bei Auswahl der feinen Geometrie kommt in allen oben genannten Stufen ein Aufpreis von $0,290 hinzu.

Erste Ebene: Eingabeweg. Text-zu-3D hat die niedrigste Einstiegsstufe; Bild-zu-3D und Multi-View kosten gleich viel und sind teurer als Text-zu-3D. Das ist intuitiv: Bild-zu-3D und Multi-View liefern mehr Information, und das Modell leistet mehr Arbeit.

Zweite Ebene: Texture- und PBR-Schalter, der Hauptpreisverstärker. Sind beide Schalter ausgeschaltet, ergibt sich die Basisstufe; mit aktivierter Texture steigt der Stückpreis eine Stufe; mit aktiviertem PBR liegt man in derselben oder einer höheren Stufe. Mit anderen Worten: Vom „reinen Geometrie“-Asset bis zum vollständigen Asset „mit Textur und PBR“ kann sich der Stückpreis mehr als verdoppeln. Dies ist die größte Preisvariable der gesamten Tabelle, deutlich bedeutsamer als die Unterschiede der Eingabewege.

Dritte Ebene: Texturfeinheit. Unter der Voraussetzung, dass Textur aktiviert ist, sind Standardtextur und feine Textur zwei verschiedene Preise. Der Aufpreis für feine Textur ist auf dem Text-zu-3D-Weg besonders ausgeprägt.

Vierte Ebene: Geometriequalität. Die Wahl von detailed (feine Geometrie) ist ein zusätzlicher Aufpreis auf die oben genannten Preise, und zwar mit demselben Aufpreisbetrag auf allen drei Wegen.

Daraus ergeben sich einige Preisbeurteilungen:

  • Wenn die nachgelagerte Stufe nur die Geometrie benötigt (etwa als Kollisionskörper oder als Grundmodell für nachträgliches manuelles Texturieren), deaktivieren Sie Texture und PBR, und der Stückpreis fällt sofort auf die niedrigste Stufe zurück.
  • Wenn es nur um Prototypenvalidierung geht, ist Text-zu-3D mit allen Schaltern aus die sparsamste Kombination.
  • Wirklich teuer ist das vollständige Lieferpaket mit „feiner Textur + PBR + feiner Geometrie“ – alles an. Das sollte eine Entscheidung sein, die erst getroffen wird, nachdem bestätigt wurde, dass das Asset online gehen soll.
Gestapelter Vergleich der drei Abrechnungsstufen: Textur- und PBR-Schalter wirken wie schrittweise angehobene Platten, die den Einzelpreis Schritt für Schritt nach oben treiben.

Empfohlene Konfigurationen und Kostenschätzungen für typische Szenarien

Nun die Struktur auf konkrete Kombinationen anwenden. Die folgenden Szenarien beziehen sich jeweils auf einen einzelnen Aufruf; die tatsächlichen Kosten summieren sich mit der Anzahl der Aufrufe.

Prototypen und Konzeptexploration

Text-zu-3D, Texture aus, PBR aus, geometry_quality auf standard, face_limit weggelassen. Dies ist die niedrigste Stufe des gesamten Modells, geeignet, um in einem Durchgang ein Dutzend Richtungen zu generieren und schnell zu filtern. Nach der Filterung lassen Sie für die ausgewählten Entwürfe erneut eine Version mit Textur laufen.

E-Commerce-/Produktpräsentations-Assets

Mit Produktbild gehen Sie zu Bild-zu-3D; wenn standardmäßiges Vier-Ansichten-Material vorliegt, zu Multi-View. Texture an, PBR an (PBR hat einen tatsächlichen Wert für die Darstellung der Materialwirkung, in Präsentationsszenarien lohnt sich dieses Geld), Textur in der Standardstufe, Geometrie standard. Wird das Produkt in Nahaufnahme betrachtet, können Sie feine Textur in Betracht ziehen.

Spiel-/Echtzeit-Rendering-Assets

Bild-zu-3D oder Multi-View, Texture an, PBR je nach Rendering-Pipeline (aktivieren, wenn die Pipeline PBR unterstützt). face_limit manuell entsprechend der Zielplattform setzen, nicht der adaptiven Entscheidung überlassen. Geometriequalität standardmäßig standard – beim Echtzeit-Rendering zeigt sich der Nutzen von detailed in der Regel nicht.

Nur geometrisches Grundmodell

Beliebiger Weg, Texture und PBR vollständig aus, Geometriequalität nach Bedarf. Dies ist die Methode, um die Kosten auf das strukturelle Minimum zu drücken; die nachträgliche Texturierung überlässt man dem Künstler-Workflow.

Ein allgemeiner Sparrhythmus: Zuerst mit einer günstigen Stufe die Richtung validieren, dann für bestätigte Assets mit einer höheren Stufe erneut laufen lassen. Zahlen Sie nicht für jeden Fehlversuch den vollen Preis.

Checkliste für Integration, Fehlersuche und Validierung

Der wichtigste Mechanismus während der Integration: Anfragen mit ungültigen Parametern werden direkt abgelehnt und nicht berechnet. Das bedeutet, Sie können in der Entwicklungsphase bedenkenlos ausprobieren – ein falsch geschriebener Feldname, ein falsches URL-Format, eine Ansichtenanzahl außerhalb des Bereichs kosten nur einen Fehler, keine Rechnung. Nutzen Sie diese Eigenschaft und bringen Sie zuerst die Parameterprüfung zum Laufen, bevor Sie über die Ergebnisqualität sprechen.

Validierungscheckliste vor dem Go-live:

  1. URL-Erreichbarkeit: Testen Sie image_url / image_urls mit einer anonymen Anfrage und stellen Sie sicher, dass HTTPS und ohne Authentifizierung zugänglich ist. Lokal öffnen zu können heißt nicht, dass es aus dem öffentlichen Netz abrufbar ist.
  2. Multi-View-Reihenfolge: Prüfen Sie Bild für Bild, ob es vorne, links, hinten, rechts ist. Dies ist der häufigste stille Fehler – die Anfrage ist erfolgreich, das Ergebnis aber schlechter, und die Ursache ist schwer zuzuordnen.
  3. Ansichtenanzahl: Bei Multi-View strikt auf 2–4 Bilder achten.
  4. Grenzen von face_limit: Bei manueller Angabe sicherstellen, dass der Wert im Bereich 1000–1.500.000 liegt; nur bei detailed erweitert sich die Obergrenze auf 2.000.000. Eine Überschreitung wird abgelehnt.
  5. Übereinstimmung der Schalter mit der Erwartung: Prüfen Sie, ob die Texture-/PBR-Schalter zur erwarteten Preisstufe passen. Zwischen Standardkonfiguration und endgültiger Konfiguration kommt es am ehesten zu Abweichungen im Sinne von „gedacht aus, tatsächlich an“.
  6. Produktvalidierung: Jeder Aufruf sollte eine GLB-Datei und ein Vorschaubild liefern. Prüfen Sie in der Integrationsschicht, ob beides vorhanden ist, bevor Sie in die nachgelagerte Stufe übergehen.
  7. Wiederholungsstrategie bei Fehlern: Unterscheiden Sie „Parameter abgelehnt“ (Parameter ändern, nicht wiederholen) von „Netzwerk-/Dienstfehler“ (Wiederholung möglich), um wiederholte kostenpflichtige Aufrufe für zwangsläufig fehlschlagende Anfragen zu vermeiden.

Wenn Sie diese Checkliste einmal durchgehen, lassen sich die meisten Probleme der Integrationsphase vor dem ersten Go-live lösen.

Drei Eingabewege entsprechen drei Materialausgangslagen, zwei Schalter bestimmen die Preisgrößenordnung, und face_limit muss nur angefasst werden, wenn Sie ein klares Budget haben. Mit dieser Reihenfolge der Entscheidungen gestaltet sich die Integration von Tripo H3.1 recht direkt – starten Sie den ersten Aufruf einfach auf der Modellseite.

Ähnliche Artikel

Alle Artikel ansehen →

Starte mit persistenten KI-Artefakten

Hol dir deinen API-Key und rufe Bild-, Video- und Audiomodelle über eine einzige task-basierte API auf.

API-Dokumentation lesen