Tripo
Tripo H3.1
tripo-h3.1/text-to-3d
Hochdetailliertes 3D-Generierungsmodell von Tripo, das aus Textaufforderungen oder einem einzelnen Bild sowie aus mehreren Ansichten texturierte 3D-Assets erzeugt, dabei Polygonanzahl und Texturqualität anpassbar macht und PBR-Materialien ausgibt – geeignet für die Erstellung von Assets wie Spiele-Requisiten und Produktvisualisierungen
tripo-h3.1/text-to-3d ausprobieren
Eingabe
Ausgabe
Preise
tripo-h3.1/text-to-3d per model
+ $0.290 feinere Geometrie · bei Auswahl von detailliert
Positionsübersicht
Dies ist ein Dienst zur Generierung von 3D-Modellen aus Text: Entwickler geben lediglich eine natürlichsprachliche Beschreibung ein und erhalten ein texturiertes 3D-Modell-Asset. Der Prompt umfasst maximal 1024 Zeichen; über einen negativen Prompt lassen sich unerwünschte Inhalte ausschließen. Zudem können Geometrie- und Texturqualität getrennt festgelegt, die Ausgabe von PBR-Materialien gesteuert, eine Obergrenze für die Anzahl der Dreiecke gesetzt sowie mehrere Zufallsseeds zur Reproduktion der Ergebnisse angegeben werden. Die generierten Ergebnisse eignen sich für Spielprototypen, Produktvisualisierungen, Konzeptdesign und andere Szenarien, in denen textuelle Ideen schnell in 3D-Modelle überführt werden sollen, und richten sich an 3D-Content-Entwickler, unabhängige Kreative und Designteams.
Wesentliche Highlights
- Direkte Generierung von 3D-Assets aus Text – Eine einzige Beschreibung genügt, um ein 3D-Modell mit Geometrie und Textur zu erzeugen, wodurch der erste Schritt der manuellen Modellierung entfällt.
- Geometrie- und Texturqualität getrennt einstellbar – Geometrie- und Texturqualität bieten jeweils die Stufen Standard und Fein, sodass sich Detailtiefe und Ausgabevolumen je nach Einsatzzweck ausbalancieren lassen.
- PBR-Materialien und Texturen zuschaltbar – Standardmäßig werden PBR-Materialien und Texturen erzeugt; Texturen und PBR lassen sich jedoch auch gemeinsam deaktivieren, sodass nur ein reines Geometriemesh erhalten bleibt, passend für verschiedene nachgelagerte Pipelines.
- Seed-Parameter zur Reproduzierbarkeit von Ergebnissen – Für Konzeptbild, Geometrie und Textur steht jeweils ein Zufallsseed zur Verfügung, um Ergebnisse unter gleichen Einstellungen zu wiederholen oder fein anzupassen.
Funktionsbeschreibung
Generierung von 3D-Modellen aus Textbeschreibungen: Auf Grundlage des Prompts wird die 3D-Geometrie aufgebaut; der Prompt umfasst maximal 1024 Zeichen, und ein negativer Prompt kann ergänzt werden, um unerwünschte Elemente auszuschließen. Ideal, um Konzept-Assets von Grund auf zu erstellen.
Gezielte Steuerung der Dreiecksanzahl: Über den Parameter für die Obergrenze der Flächen lässt sich die Zielanzahl der Dreiecke festlegen; der Wertebereich reicht von 1000 bis 1,5 Millionen (bei feiner Geometrie 2 Millionen). Wird nichts festgelegt, entscheidet das Modell selbstadaptiv, was die Abstimmung auf die Anforderungen des nachgelagerten Renderings erleichtert.
Ausgabe von PBR-Materialien und Texturen: Standardmäßig werden PBR-Materialien und Texturen erzeugt; sind Textur und PBR gleichzeitig deaktiviert, wird ein reines Geometriemesh ausgegeben. Die Texturqualität ist wahlweise Standard oder Fein, wobei die Stufe Fein höher aufgelöste Texturen liefert.
Einstellbare Geometriefeinheit: Die Geometriequalität lässt sich zwischen Standard und Fein wählen; die Stufe Fein ergänzt feinere Mesh-Details und eignet sich für Assets, die in Nahaufnahme präsentiert oder später weiter verfeinert werden sollen.
Anwendungsszenarien
- Schnelle Erstellung von Requisitenmodellen für Spielprototypen – Designer oder unabhängige Entwickler beschreiben das Aussehen einer Requisite in Text, erzeugen ein texturiertes 3D-Modell und importieren es in die Engine für Prototypenvalidierung und Levelaufbau.
- Erstellung von Konzept-Assets für die Produktvisualisierung – Designteams erzeugen anhand einer Produktbeschreibung 3D-Modelle für frühe Präsentationen von Lösungen, Marketing-Visualisierungsentwürfe und interne Reviews.
- Iteration im 3D-Konzeptdesign – Konzeptdesigner erzeugen mit verschiedenen Prompts und Seeds Varianten im Batch, vergleichen schnell Gestaltungsrichtungen und wählen Assets für die Verfeinerungsphase aus.
Einschränkungen und Auswahlhinweise
Die Prompt-Länge ist auf 1 bis 1024 Zeichen begrenzt; darüber hinaus kann nichts übermittelt werden. Die Obergrenze der Flächen akzeptiert nur ganze Zahlen zwischen 1000 und 1,5 Millionen (bei feiner Geometrie 2 Millionen); wird nichts festgelegt, bestimmt das Modell die Dreiecksanzahl selbst. Texturqualität und Geometriequalität sind jeweils Auswahlmöglichkeiten zwischen zwei Optionen, von denen pro Anfrage nur eine Stufe gewählt werden kann. Sind Textur und PBR beide deaktiviert, ist das Ergebnis ein reines Geometriemesh ohne Oberflächentexturen. Die Seed-Parameter erhöhen die Reproduzierbarkeit, doch garantieren gleiche Seeds keine vollständig identischen Ergebnisse.
Neuigkeiten
Changelog ansehen →- Neues Modell tripo-h3.1/multiview-to-3d ist verfügbar: Tripo H3.1 Multi-View-zu-3D
- Neues Modell tripo-h3.1/text-to-3d ist verfügbar: Tripo H3.1 Text-zu-3D
- Neues Modell tripo-h3.1/image-to-3d jetzt verfügbar: Tripo H3.1 Bild-zu-3D
Häufige Fragen
Alle Fragen ansehen →-
Wie hoch ist das Obergrenzen-Limit für die Flächenzahl, sind 2 Millionen möglich?
Ja, das Limit für face_limit liegt bei 2 Millionen Dreiecken, aber die vollen 2 Millionen werden nur tatsächlich unterstützt, wenn geometry_quality auf detailed gesetzt ist; bei standard sollten Sie höchstens 1,5 Millionen einstellen. Wenn face_limit nicht übergeben wird, entscheidet das Modell die Flächenzahl adaptiv.
-
Wie erhalte ich zunächst nur eine Geometrie ohne Texturen?
Setzen Sie sowohl texture als auch pbr auf false; wenn pbr true ist, werden Texturen zwangsweise generiert. Wenn Sie Texturen, aber kein PBR-Material benötigen, setzen Sie texture auf true und pbr auf false.
-
Müssen für hochdichte Geometrie separate Parameter aktiviert werden?
Wenn geometry_quality auf detailed gesetzt wird, werden feinere Netzdetails ergänzt, was auch die Voraussetzung dafür ist, dass die Polygonzahl 2 Millionen erreichen kann; wenn detailliertere Texturen benötigt werden, setzt man texture_quality auf detailed. Beide sind standardmäßig auf standard eingestellt und werden je nach Nahaufnahme-Anforderung des Ziel-Assets zusätzlich aktiviert.
-
Wie lassen sich die Generierungsergebnisse reproduzieren, um verschiedene Parameter bequem zu vergleichen?
Geometrie und Textur haben jeweils einen festen Seed: model_seed steuert die Geometrie, texture_seed steuert die Textur, und bei der textbasierten 3D-Generierung gibt es zusätzlich image_seed, der das Konzeptbild steuert. Beim Vergleich von Parametern sollte man zuerst die Seeds festlegen und nur einen Parameter ändern, um beurteilen zu können, von welchem Element die Unterschiede stammen.
Generierungsaufgabe erstellen
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringPflichtAccount-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen
Content-TypestringOptionalDer Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.
Idempotency-KeystringOptionalIdempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.
Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.
Body
modelstringPflichtAktueller Festwert: tripo-h3.1/text-to-3d
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für tripo-h3.1/text-to-3d und Route default — siehe Parametertabelle unten.
pbrbooleanOptionalStandard: trueOb ein PBR-Material generiert werden soll; boolescher Wert, Standard true; bei true werden zusätzlich Textur-Maps ausgegeben.
promptstringPflichtminLength 1maxLength 1024Der Beschreibungstext des zu generierenden Objekts, z. B. eine kleine Keramik-Teekanne, als Eingabe-Prompt für Text-zu-3D.
texturebooleanOptionalStandard: trueOb für das Modell eine Textur generiert werden soll, Standard true. Hinweis: Bei pbr=true wird die Texturgenerierung erzwungen; nur wenn sowohl texture als auch pbr auf false gesetzt sind, wird ein reines Geometrie-Mesh ausgegeben.
face_limitintegerOptionalmin 1000max 2000000Zielanzahl der Dreiecksflächen als Ganzzahl, Bereich 1000–1500000 (bei geometry_quality=detailed maximal 2000000); wird der Wert weggelassen, entscheidet das Modell die Flächenanzahl selbstständig, wodurch die Datei meist recht groß wird; für die Darstellung im Web werden etwa 50000 empfohlen.
image_seedintegerOptionalZufallsseed für die Generierung des Konzeptbilds als Ganzzahl, um dasselbe Konzeptbild-Ergebnis zu reproduzieren.
model_seedintegerOptionalReproduzierbarer Zufallsseed für die Geometriegenerierung als Ganzzahl, um dasselbe Geometrie-Ergebnis stabil zu reproduzieren.
texture_seedintegerOptionalReproduzierbarer Zufallsseed für die Texturgenerierung als Ganzzahl, um dasselbe Textur-Ergebnis stabil zu reproduzieren.
negative_promptstringOptionalmaxLength 1024Negativ-Prompt, der beschreibt, welche Inhalte bei der Generierung vermieden werden sollen.
texture_qualitystringOptionalStandard: "standard"Qualitätsstufe der Textur als Zeichenkette, Standard standard; die Stufe detailed erzeugt Texturen mit höherer Auflösung.
standarddetailedgeometry_qualitystringOptionalStandard: "standard"Qualitätsstufe der Geometrie als Zeichenkette, Standard standard; die Stufe detailed liefert feinere Mesh-Details.
standarddetailedcallbackobjectOptional
Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.
Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.
urlstringPflichtPflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.
whenstringOptionalStandard: "final"Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.
finalstoragestringOptionalStandard: "temp"Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.
temppersistentAnfragebeispiele
# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "tripo-h3.1/text-to-3d",
input: {
"pbr": true,
"prompt": "…",
"texture": true,
"texture_quality": "standard",
"geometry_quality": "standard"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "tripo-h3.1/text-to-3d",
"input": {
"pbr": True,
"prompt": "…",
"texture": True,
"texture_quality": "standard",
"geometry_quality": "standard"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Aufgabendetails abrufen
https://api.hiapi.ai/v1/tasks/:id Antwortfelder
taskIdstringPflichtAufgaben-ID, stets mit Präfix tk-hiapi-.
modelstringPflichtAufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.
routestringOptionalErscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.
statusstringPflichtAufgabenstatus.
queued Eingereiht, noch nicht gestartet.
handling In Verarbeitung.
archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet.
success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben).
fail Endzustand: fehlgeschlagen (error wird zurückgegeben).
Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.
creatednumberPflichtZeitpunkt der Aufgabenerstellung (Unix-Sekunden).
completednumberPflichtUnix-Sekunden des Endzustands; vor Abschluss stets 0.
outputarrayOptional
Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).
Array [ object ]
Array-Elemente
urlstringPflichtArtefakt-URL, direkt herunterladbar.
typestringPflichtAktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.
expireAtnumberPflichtUnix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.
errorobjectOptional
Nur bei status == fail.
codestringPflichtBusiness-Fehlercode.
messagestringPflichtFehlerbeschreibung.
Antwortbeispiele
Erfolg
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In Bearbeitung (nicht final)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fehlgeschlagen
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artikel
Alle Artikel ansehen →-
Vergleichstest
Tripo H3.1 im Quervergleich und Auswahlleitfaden: Wie man die drei Wege der 3D-Generierung wählt und Kosten spart
Ausgehend von Eingabeform, geometrischer Verfeinerung und PBR-/Textur-Schaltern eine entwicklerorientierte Abwägung von Preis und Leistungsfähigkeit
-
Benutzerhandbuch
Tripo H3.1 Einstiegsleitfaden: Drei Eingabewege, Parameter und Preiswahl
Praktische Entscheidungsfindung und Kostenkontrolle bei der 3D-Generierungsintegration für Entwickler
-
Tutorial
Tripo H3.1 Anwendungsszenarien in der Praxis: 5 wertvolle Einsatzmöglichkeiten und Umsetzungshinweise
Von Text-zu-3D bis Multi-View-Rekonstruktion: den richtigen Modus und die richtigen Parameter je nach Geschäftsszenario wählen