Tripo
Tripo H3.1
tripo-h3.1/multiview-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/multiview-to-3d ausprobieren
Eingabe
Laden Sie nacheinander verschiedene Ansichten desselben Objekts hoch: Vorderseite (erforderlich), linke Seite, Rückseite, rechte Seite; mindestens 2, höchstens 4 Bilder; nur JPG, PNG und WEBP werden unterstützt.
Ausgabe
Preise
tripo-h3.1/multiview-to-3d per model
+ $0.290 feinere Geometrie · bei Auswahl von detailliert
Positionsübersicht
Ein Werkzeug zur Erzeugung von 3D-Modellen aus mehreren Ansichten, das 2 bis 4 Bilder desselben Objekts aus verschiedenen Blickwinkeln entgegennimmt und ein 3D-Asset mit geometrischer Struktur ausgibt. Die Eingabebilder werden in der Reihenfolge vorne, links, hinten, rechts bereitgestellt; geeignet für Fachleute aus Game-Art und Produktvisualisierung, die über Produktfotos oder Rundum-Aufnahmen verfügen und reale Objekte oder Designentwürfe schnell in ein weiterbearbeitbares, renderbares oder exportierbares 3D-Modell umwandeln möchten.
Wesentliche Highlights
- Geometrie durch Mehrfachansichten eingeschränkt – Es können 2 bis 4 Bilder desselben Objekts aus unterschiedlichen Blickwinkeln gemeinsam modelliert werden, wodurch die Kontur stärker eingeschränkt wird als bei einem Einzelbild.
- Feinheit von Geometrie und Textur einstellbar – Für Geometrie- und Texturqualität stehen jeweils zwei Stufen zur Auswahl, Standard oder Detailliert (standard / detailed), um je nach Einsatzzweck zwischen Geschwindigkeit und Detailfülle abzuwägen.
- Flexible Steuerung von Material und Polygonzahl – Textur und PBR-Material können aktiviert oder deaktiviert werden; außerdem lässt sich eine Ziel-Trigonszahl von 1000 bis 1,5 Millionen (bei detaillierter Geometrie 2 Millionen) angeben.
- Stil- und Reproduktionssteuerung – Die Ausrichtung kann an die Eingabebilder angepasst werden; Geometrie und Textur besitzen jeweils einen Zufalls-Seed, um Ergebnisse zu fixieren.
Funktionsbeschreibung
Modellierung aus Mehrfachansichten: Es werden 2 bis 4 HTTPS-Bilder übergeben, die dasselbe Objekt in der Reihenfolge vorne, links, hinten, rechts zeigen, und daraus das entsprechende 3D-Modell-Asset erzeugt.
Textur und PBR-Material: Standardmäßig werden Textur und PBR-Material erzeugt; ebenso können Textur und PBR gleichzeitig deaktiviert werden, sodass nur ein reines Geometriemesh erhalten bleibt. Die Texturqualität ist wahlweise Standard oder Detailliert.
Steuerung der Polygonobergrenze: Eine Ziel-Trigonszahl von 1000 bis 1,5 Millionen (bei detaillierter Geometrie 2 Millionen) kann angegeben werden; bleibt das Feld leer, entscheidet das Modell selbstadaptiv, um das Budget nachgelagerter Pipelines zu treffen.
Ausrichtung und Anpassungsmodus: Bei der Ausrichtung „An Eingabebild ausrichten“ (align_image) wird automatisch gedreht, um das Eingabebild zu treffen; die Texturausrichtung (texture_alignment) kann entweder am Originalbild oder an der Geometrie ausgerichtet werden.
Reproduktion über Zufalls-Seeds: Für Geometrie und Textur werden jeweils ganzzahlige Seeds gesetzt, die bei gleichen Eingaben und Einstellungen helfen, das erzeugte Ergebnis zu reproduzieren.
Anwendungsfälle
- Rundum-Produktfotos in 3D-Assets umwandeln – E-Commerce- oder Produktteams nutzen Produktfotos aus mehreren Winkeln als Eingabe und erhalten ein texturiertes 3D-Modell für die 3D-Darstellung im Web oder für Marketingbilder.
- Prototypen für Game- und Szenen-Art – Kunstschaffende erzeugen aus Mehrfachansichts-Designentwürfen von Charakteren oder Requisiten ein Mesh mittlerer Polygonzahl und importieren es als Nahbereichs-Requisite oder Konzeptprüfungs-Asset in die Engine.
- Aufbereitung von Scan-Material und Retopologie-Referenz – Digital-Asset-Teams erzeugen aus Mehrfachansichts-Scans ein texturiertes Referenzmodell als Vergleichsbasis für manuellen Nachbau oder Materialerstellung.
Einschränkungen und Auswahlhinweise
Die Bilder müssen HTTPS-Adressen sein; pro Anfrage sind 2 bis 4 Ansichten desselben Objekts bereitzustellen, bei weniger oder mehr ist keine Übermittlung möglich. Die Ziel-Trigonszahl ist auf 1000 bis 1,5 Millionen (bei detaillierter Geometrie 2 Millionen) begrenzt; eine höhere Polygonzahl stellt größere Anforderungen an die Leistung der nachgelagerten Verarbeitung. Textur und PBR-Material können gleichzeitig deaktiviert werden; danach wird nur ein reines Geometriemesh ausgegeben. Die Stufe „Detailliert“ (detailed) erhöht die Detailfülle und verlängert zugleich die Verarbeitungszeit. Zufalls-Seeds können nur bei der Reproduktion helfen, garantieren aber nicht, dass mehrere Erzeugungen völlig identisch sind.
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/multiview-to-3d
routestringOptionalAktueller Festwert: default
inputobjectPflicht
Geschäftsparameter für tripo-h3.1/multiview-to-3d und Route default — siehe Parametertabelle unten.
pbrbooleanOptionalStandard: trueGibt an, ob PBR-Materialtexturen generiert werden; bei true werden gleichzeitig Textur-Maps erzeugt, Standard ist true.
texturebooleanOptionalStandard: trueGibt an, ob für das Modell Texturen generiert werden, Standard ist true. Beachten Sie: Wenn pbr true ist, werden Texturen zwangsweise generiert; 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 im Bereich 1000–1500000 (bei geometry_quality=detailed maximal 2000000); wird der Wert weggelassen, bestimmt das Modell die Flächenanzahl adaptiv, die Datei ist dann meist relativ groß, für die Webdarstellung werden etwa 50000 empfohlen.
image_urlsarrayPflichtminItems 2maxItems 4Array aus HTTPS-URLs von 2–4 Ansichtsbildern desselben Objekts, geordnet in der Reihenfolge Vorderansicht, links, Rückansicht, rechts; das erste Bild muss die Vorderansicht sein.
Array [ string ]
model_seedintegerOptionalZufallsseed für die Geometriegenerierung als Ganzzahl, um dasselbe Geometrieergebnis zu reproduzieren.
orientationstringOptionalStandard: "default"Einstellung der Modellausrichtung als Zeichenkette; bei align_image wird automatisch gedreht, um das Modell an das Eingabebild auszurichten, Standard ist default.
defaultalign_imagetexture_seedintegerOptionalZufallsseed für die Texturgenerierung als Ganzzahl, um dasselbe Texturergebnis zu reproduzieren.
texture_qualitystringOptionalStandard: "standard"Qualitätsstufe der Textur als Zeichenkette; die Stufe detailed erzeugt Texturen mit höherer Auflösung, Standard ist standard.
standarddetailedgeometry_qualitystringOptionalStandard: "standard"Qualitätsstufe der Geometrie als Zeichenkette; die Stufe detailed liefert feinere Mesh-Details, Standard ist standard.
standarddetailedtexture_alignmentstringOptionalStandard: "original_image"Ausrichtungsmethode der Textur am Eingabebild als Zeichenkette, Standard ist 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/multiview-to-3d",
"input": {
"pbr": true,
"texture": true,
"image_urls": "…",
"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/multiview-to-3d",
input: {
"pbr": true,
"texture": true,
"image_urls": "…",
"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/multiview-to-3d",
"input": {
"pbr": True,
"texture": True,
"image_urls": "…",
"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