Tripo
Tripo H3.1
tripo-h3.1/image-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/image-to-3d ausprobieren
Eingabe
Laden Sie ein Foto eines einzelnen Objekts vor einem sauberen Hintergrund als Eingabe für die Generierung hoch. Unterstützt werden nur JPG, PNG, WEBP.
Ausgabe
Preise
tripo-h3.1/image-to-3d per model
+ $0.290 feinere Geometrie · bei Auswahl von detailliert
Einordnung und Kurzprofil
Gedacht für Entwickler und Designteams, die aus einem einzelnen Foto schnell 3D-Assets erzeugen möchten. Es genügt die Angabe eines HTTPS-Bildes eines Objekts auf sauberem Hintergrund, um ein 3D-Modell mit Geometrie und optionaler Textur zu erhalten – ideal, um Fotos realer Objekte rasch in digitale Assets umzuwandeln, die sich ansehen, rendern oder weiterbearbeiten lassen.
Zentrale Highlights
- 3D-Modell aus einem einzigen Bild – ein Link zu einem Foto eines Objekts auf sauberem Hintergrund genügt, um die Erzeugung zu starten; ideal, um reale Objekte oder Entwürfe schnell zu digitalisieren.
- Geometrie und Textur getrennt steuerbar – Textur und PBR lassen sich gemeinsam abschalten, sodass nur ein Geometrie-Mesh entsteht; alternativ lassen sich Qualitätsstufen für Geometrie und Textur getrennt festlegen, je nach Verwendungszweck.
- Obergrenze der Dreiecksflächen selbst festlegbar – die Zielanzahl an Dreiecken kann zwischen 1000 und 1,5 Millionen (bei detaillierter Geometrie 2 Millionen) liegen, passend für Downstream-Pipelines unterschiedlicher Präzision.
- Reproduzierbare Ergebnisse – für Geometrie und Textur lässt sich jeweils ein Zufalls-Seed setzen; zusammen mit festen Parametern erleichtert das wiederholte Generierungen und Ergebnisvergleiche.
Funktionsbeschreibung
3D-Mesh aus Bild erzeugen: Eingabe ist der HTTPS-Link zu einem einzelnen Objektfoto, Ausgabe ein 3D-Modell; sind Textur und PBR zugleich deaktiviert, entsteht nur ein reines Geometrie-Mesh – sinnvoll, wenn zuerst die Form festgelegt und später nachbearbeitet werden soll.
Zielanzahl der Flächen steuern: Über die Obergrenze der Flächen (face_limit) lässt sich eine Zielanzahl an Dreiecken zwischen 1000 und 1,5 Millionen (bei detaillierter Geometrie 2 Millionen) festlegen; bleibt der Wert leer, entscheidet das Modell selbst, passend zu den Genauigkeitsanforderungen von Rendering- oder Leichtgewicht-Szenarien.
Textur- und PBR-Schalter: Die Textur ist standardmäßig aktiviert und es wird standardmäßig ein PBR-Material erzeugt; bei aktiviertem PBR wird die Textur zwangsweise erzeugt, nur wenn Textur und PBR beide ausgeschaltet sind, bleibt ausschließlich die Geometrie erhalten – je nach Downstream-Verwendung wählen.
Wechsel der Qualitätsstufen: Für Geometriequalität und Texturqualität ist jeweils Standard oder Detailliert (standard / detailed) wählbar; die detaillierte Stufe liefert feinere Mesh-Details bzw. Texturen mit höherer Auflösung.
Ausrichtung und Texturausrichtung: Mit der Ausrichtung (orientation) „An Eingabebild ausrichten“ (align_image) wird das Modell automatisch gedreht, um zum Eingabebild zu passen; die Texturausrichtung (texture_alignment) kann am Originalbild oder an der Geometrie ausgerichtet werden.
Geeignete Szenarien
- Fotos realer Objekte als digitale Assets – E-Commerce- oder Designteams erzeugen aus Fotos handgehaltener Objekte 3D-Modelle und stellen sie auf Produktseiten oder in 3D-Viewern zum interaktiven Drehen bereit.
- Konzeptdesign schnell in 3D bringen – Konzeptdesigner wandeln Skizzen oder Referenzbilder in 3D-Meshes um und nutzen sie in Modellierungssoftware als Ausgangspunkt für Proportionen und Grundvolumen zur weiteren Ausarbeitung.
- 3D-Grundlage für Marketingmaterial – Marketingteams erzeugen aus Produktbildern texturierte Modelle und importieren sie in Rendering- oder Animations-Pipelines, um dreidimensionale Produktmotive für Werbegrafiken herzustellen.
- Vorgefertigte Leichtgewicht-Assets – Entwickler legen eine niedrigere Flächenanzahl und Standardtexturen fest und erzeugen in großen Mengen 3D-Präsentationsassets für Mobilgeräte oder Echtzeit-Szenarien.
Einschränkungen und Auswahlhinweise
Als Eingabe wird ausschließlich ein HTTPS-Bildlink zu einem einzelnen Objekt auf sauberem Hintergrund akzeptiert; Bilder mit unruhigem Hintergrund oder mehreren Objekten im Bild liefern nicht unbedingt eine zufriedenstellende Geometrie. Die Zielanzahl der Flächen ist auf 1000 bis 1,5 Millionen (bei detaillierter Geometrie 2 Millionen) Dreiecke begrenzt; eine niedrige Flächenanzahl kostet Details. Sind Textur und PBR deaktiviert, ist die Ausgabe eine Geometrie ohne Material. Texturausrichtung und Ausrichtungseinstellung beeinflussen das endgültige Aussehen und müssen passend zum Eingabebild gewählt werden; das Ergebnis stimmt nicht zwangsläufig an jeder Stelle mit dem Foto überein.
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/image-to-3d
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für tripo-h3.1/image-to-3d und Route default — siehe Parametertabelle unten.
pbrbooleanOptionalStandard: trueSteuert, ob PBR-Materialien generiert werden; bei true werden zusätzlich Textur-Maps erzeugt. Standard: true.
texturebooleanOptionalStandard: trueOb Texturen für das Modell generiert werden, Standard: true. Beachten Sie: Wenn pbr auf true gesetzt ist, wird die Texturgenerierung erzwungen; nur wenn sowohl texture als auch pbr auf false gesetzt sind, wird ein reines Geometrie-Mesh ausgegeben.
image_urlstringPflichtpattern ^https://HTTPS-Adresse eines einzelnen Objektfotos; der Bildhintergrund muss sauber sein. Dient als Eingabebild für die Bild-zu-3D-Generierung.
face_limitintegerOptionalmin 1000max 2000000Zielanzahl der Dreiecke als Ganzzahl im Bereich 1000–1500000 (bei geometry_quality=detailed maximal 2000000); wird der Wert weggelassen, bestimmt das Modell die Anzahl der Flächen adaptiv. Die Dateien sind dann meist recht groß; für die Darstellung im Web werden etwa 50000 empfohlen.
model_seedintegerOptionalZufallsseed für die Geometriegenerierung als Ganzzahl, um identische Geometrieergebnisse zu reproduzieren.
orientationstringOptionalStandard: "default"Steuert die Ausrichtung des Modells; align_image richtet das Modell automatisch anhand des Eingabebilds aus. Standard: default.
defaultalign_imagetexture_seedintegerOptionalZufallsseed für die Texturgenerierung als Ganzzahl, um identische Texturergebnisse zu reproduzieren.
texture_qualitystringOptionalStandard: "standard"Steuert die Texturqualität; detailed erzeugt Texturen mit höherer Auflösung. Standard: standard.
standarddetailedgeometry_qualitystringOptionalStandard: "standard"Steuert die Geometriequalität; detailed ergänzt feinere Mesh-Details. Standard: standard.
standarddetailedtexture_alignmentstringOptionalStandard: "original_image"Steuert die Ausrichtung der Textur am Eingabebild. Standard: original_image.
original_imagegeometrycallbackobjectOptional
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/image-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_url": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}' 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/image-to-3d",
input: {
"pbr": true,
"texture": true,
"image_url": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
}),
});
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/image-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_url": "…",
"orientation": "default",
"texture_quality": "standard",
"geometry_quality": "standard",
"texture_alignment": "original_image"
}
},
)
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 →-
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
-
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