Bild zu 3DÜber Tripo H3.1
Genaue 3D-Formen und echte Farben aus einem Produktfoto.
Du rufst es mit dem Modellnamen tripo/h3.1/image-to-3d über POST /jobs/createTask auf, ab 0,432 $.
Einführung
Tripo H3.1 ist das Bild-zu-3D-Modell, das Tripo AI im März 2026 für produktionsreife Assets vorgestellt hat. Es bietet schärfere Geometrie, eine bessere Übereinstimmung mit dem Eingabebild und qualitativ hochwertigere Texturen als die früheren H-Modelle. Sie senden ein Bild (image_url) und erhalten eine binäre glTF-Datei (.glb) zurück. Anders als einfache Ein-Schalter-Konverter ist jede Stufe der Pipeline einstellbar: ob das Mesh texturiert werden soll, ob PBR-Karten, HD-Texturen, detaillierte Geometrie, Quad-Topologie, eine Zielanzahl an Flächen, reale Skalierung, die finale Ausrichtung und zwei getrennte Seeds einbezogen werden. Es gibt kein Prompt.
Wichtigste Funktionen
Form, die dem Bild folgt
Im Stiefeltest behielt das Modell die Proportionen des Fotos bei und setzte Fersenschlaufe, Schnürhaken und Profil auf die richtigen Seiten, obwohl das Foto nur die Front zeigte. Das texturierte Ergebnis übertrug das abgetragene Leder, die roten Schnürsenkel und die Nähte auf das Mesh.
Texturen, die Sie ein- und ausschalten und verbessern können
Texturen sind standardmäßig aktiv und kommen als vollständiger PBR-Satz. Unsere Datei mit Standardeinstellungen enthielt in einem Material eine Basisfarbkarte mit 2048 Pixeln, eine Metallic-Roughness-Karte und eine Normal-Map.
Topologie und Größe unter Kontrolle
face_limit begrenzt die Anzahl der Flächen auf einen Wert zwischen 1.000 und 2.000.000, quad_mesh wechselt zu vierseitigen Polygonen für die Bearbeitung in einem Modellierungswerkzeug, und geometry_quality: detailed investiert mehr in feine Oberflächendetails. auto_size skaliert das Mesh auf reale Maße, und model_orientation: align_image richtet es am Bild aus.
Was wir gemessen haben
Mit den Standardeinstellungen kam eine Frontansicht eines Lederstiefels (1024×1024) nach 167 Sekunden als 45,8 MB große GLB-Datei mit 1.471.382 Dreiecken und drei Texturen zurück. Diese Dichte ist der Grund, warum Sie face_limit für alles setzen sollten, was im Browser gezeigt wird.
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
auto_size | Nein | Das Mesh auf geschätzte reale Abmessungen skalieren. Standardmäßig aus. Standardwert: false |
face_limit | Nein | Ziel-Flächenanzahl von 1.000 bis 2.000.000. Leer lassen, damit das Modell entscheidet (oft über eine Million Flächen). ≥ 1000 · ≤ 2000000 |
generate_pbr | Nein | PBR-Materialkarten hinzufügen (Metall-Rauheit und Normal). Standardmäßig an und aktiviert die Textur. Standardwert: true |
generate_texture | Nein | Die Oberfläche des Meshes mit einer Textur versehen. Standardmäßig an; ausgeschaltet entfällt die Textur nur, wenn auch generate_pbr aus ist. Standardwert: true |
geometry_quality | Nein | Geometriedetail: standard (Standard) oder detailed. detailed erzeugt feinere Oberflächendetails und kostet mehr. standard · detailed · Standardwert: standard |
image_url | Ja | Das Bild, von dem aus es losgeht. |
model_orientation | Nein | default behält die Standardausrichtung bei; align_image dreht das Modell passend zum Bild. default · align_image · Standardwert: default |
quad_mesh | Nein | Vierseitige (Quad-)Polygone statt Dreiecke zurückgeben, zur Bearbeitung in Modellierprogrammen; die Datei kommt dann als FBX statt GLB zurück. Standardmäßig aus; erhöht den Preis. Standardwert: false |
seed | Nein | Verwende denselben Seed und dieselben Einstellungen für besser kontrollierte Vergleiche. ≥ 0 · ≤ 2147483647 |
texture_alignment | Nein | Die Textur am Originalbild (Standard) oder an der erzeugten Geometrie ausrichten. original_image · geometry · Standardwert: original_image |
texture_quality | Nein | Texturauflösung: standard (Standard) oder detailed. detailed kostet mehr und gilt nur für texturierte Meshes. standard · detailed · Standardwert: standard |
texture_seed | Nein | Seed für den Texturschritt. Seed unverändert lassen und diesen Wert ändern, um auf derselben Form neue Texturen zu testen. ≥ 0 · ≤ 2147483647 |
Preise
Die Preise sind in USD angegeben. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.
| Option | USD pro Ausführung |
|---|---|
| Standard | 0,432 $ |
Sende vor dem Start denselben Anfrage-Body an POST /jobs/quote, um die geschätzten und maximalen Kosten in USD zu sehen. Die Preisabfrage führt keine Aufgabe aus und belastet dein Guthaben nicht.
Anwendungsfälle
Assets für Spiele, AR und Echtzeitszenen
Setzen Sie face_limit auf das Budget Ihrer Szene, aktivieren Sie quad_mesh, wenn das Asset später bearbeitet wird, und lassen Sie PBR eingeschaltet, damit das Modell auf die Beleuchtung reagiert.
Produktvisualisierung und Druck
Für einen Produkt-Viewer lassen Sie Texturen an und verwenden texture_quality: detailed, wenn Beschriftungen oder Nähte lesbar bleiben müssen. Für 3D-Druck oder Bildhauerei schalten Sie beide Textur-Schalter aus und setzen auto_size, damit das Mesh in realistischer Größe ankommt.
Prompt-Leitfaden & Profi-Tipps
Mit einem sauberen Bild beginnen
Ein Motiv, vollständig im Bild, auf einem einfarbigen Hintergrund. Eine Dreiviertelansicht vermittelt dem Modell mehr über die Tiefe als eine gerade Frontansicht. JPEG, PNG oder WebP bis 10 MB.
Nur einschalten, was Sie brauchen
Machen Sie einen ersten Durchlauf mit den Standardwerten und einem face_limit, und verbessern Sie danach nur die Stufe, die nicht reicht.
Mit den zwei Seeds iterieren
seed fixiert die Geometrie, texture_seed die Textur. Behalten Sie seed und ändern Sie texture_seed, um neue Oberflächen auf derselben Form auszuprobieren; oder behalten Sie texture_seed, während Sie Formen erkunden.
Die verdeckte Seite prüfen
Öffnen Sie die GLB-Datei im Viewer und drehen Sie sie vor der Verwendung einmal ganz herum. Ist die nicht sichtbare Seite falsch, hilft ein anderer Kamerawinkel im Ausgangsbild mehr als jede Einstellung.
API-Schnellstart
Die Tripo H3.1 API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow-. API-Aufrufe nutzen dein separates Guthaben in US-Dollar.
- Anfrage senden. Sende POST /jobs/createTask mit model tripo/h3.1/image-to-3d und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "tripo/h3.1/image-to-3d",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"generate_texture": true,
"generate_pbr": true,
"texture_quality": "standard",
"geometry_quality": "standard",
"model_orientation": "default"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Tripo H3.1 API
Was kostet die Tripo H3.1 API?
Tripo H3.1 kostet 0,432 $ pro Ausführung. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.
Wie lautet der Modellname von Tripo H3.1 in der API?
Trag tripo/h3.1/image-to-3d für Bild zu 3D im Feld model von POST /jobs/createTask ein.
Was steckt in der GLB?
Ein Mesh mit eingebettetem Material. Mit Standardeinstellungen enthielt unsere Datei drei Texturen – Grundfarbe, Metall-Rauheit und Normal-Map –, alle mit 2048 Pixeln. Schalten Sie generate_texture und generate_pbr aus, bekommen Sie das reine Mesh.
Wie halte ich die Datei klein?
Setzen Sie face_limit, etwa 50.000 bis 200.000 für Web-Viewer. Leer gelassen entscheidet das Modell – in unserem Lauf waren das über eine Million Dreiecke.
Kann ich ein Ergebnis reproduzieren?
Ja. seed fixiert den Geometrieschritt, texture_seed den Texturschritt. So behalten Sie die Form und probieren eine andere Textur – oder umgekehrt.
Welche Limits hat die Tripo H3.1 API?
Größter Upload: 10 MB. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Tripo H3.1 testen, ohne Code zu schreiben?
Teste Tripo H3.1 im Playground mit deinem API-Guthaben in USD, ganz ohne API-Schlüssel. Jeder Lauf erscheint mit dem passenden Code im Entwicklerverlauf.
