Remesh-API

Die ID der abgeschlossenen Image to 3D- oder Text to 3D-Aufgabe, die Sie remeshen möchten. Diese Aufgabe muss eine der folgenden Aufgaben sein: Text to 3D Preview, Text to 3D Refine, Image to 3D oder Retexture. Außerdem muss sie den Status SUCCEEDED haben.

Bitte stellen Sie Meshy ein 3D-Modell zum Remeshen über eine öffentlich zugängliche URL oder Daten-URI bereit. Unterstützte Formate: .glb, .gltf, .obj, .fbx, .stl.

Verwenden Sie für Daten-URIs den MIME-Typ: application/octet-stream.

Eine Liste der Zielformate für das remeshte Modell. Wenn sie weggelassen wird, wird nur GLB generiert.

Verfügbare Werte: glb, fbx, obj, usdz, blend, stl, 3mf.

Geben Sie die Topologie des generierten Modells an.

Verfügbare Werte:

• quad: Generiert ein überwiegend aus Quads bestehendes Mesh.
• triangle: Generiert ein dezimiertes Dreiecks-Mesh.

Geben Sie die Zielanzahl der Polygone im generierten Modell an. Die tatsächliche Anzahl der Polygone kann je nach Komplexität der Geometrie vom Zielwert abweichen.

Der gültige Wertebereich variiert je nach Benutzerstufe:

• 100 bis 300.000 (inklusive)

Aktivieren Sie die adaptive Dezimierung, indem Sie eine Polygonanzahl-Stufe festlegen. Wenn dies festgelegt ist, wird target_polycount ignoriert.

Verfügbare Werte:

• 1: Adaptiv — ultra Polygonanzahl.
• 2: Adaptiv — hohe Polygonanzahl.
• 3: Adaptiv — mittlere Polygonanzahl.
• 4: Adaptiv — niedrige Polygonanzahl.

Ändern Sie die Größe des Modells auf eine bestimmte Höhe, gemessen in Metern. Wir empfehlen stattdessen die Verwendung der dedizierten Resize API.

Ändern Sie die Größe des Modells so, dass die längste Dimension der Bounding Box dem angegebenen Wert in Metern entspricht. Wir empfehlen stattdessen die Verwendung der dedizierten Resize API.

Wenn auf true gesetzt, verwendet der Dienst KI-Vision, um die reale Höhe des Objekts automatisch zu schätzen und die Größe des Modells entsprechend anzupassen. Wir empfehlen stattdessen die Verwendung der dedizierten Resize API.

Wenn true, ändert der Dienst nur das Format der Eingabemodelldatei und ignoriert andere Eingaben wie topology, resize_height und target_polycount. Wir empfehlen stattdessen die Verwendung der dedizierten Convert API.

Wenn auf true gesetzt, rendert die Aufgabe zusätzlich eine Version der Vorschau mit transparentem Hintergrund (RGBA) und gibt sie in der GET-Antwort als alpha_thumbnail_url zurück. Das vorhandene Feld thumbnail_url bleibt unverändert.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Entweder model_url oder input_task_id muss angegeben werden.
• Ungültige Eingabeaufgabe: Die input_task_id muss auf eine erfolgreiche Aufgabe aus einem unterstützten Modell verweisen.
• Ungültiges Modellformat: Die model_url verweist auf eine Datei mit einer nicht unterstützten Erweiterung.
• Nicht erreichbare URL: Die model_url konnte nicht heruntergeladen werden.
• Ungültige Topologie: Der Parameter topology ist ungültig.
• Sich gegenseitig ausschließende Parameter: auto_size und resize_height können nicht beide gesetzt werden.

Authentifizierung fehlgeschlagen. Bitte überprüfen Sie Ihren API key.

Unzureichende credits, um diese Aufgabe auszuführen.

Sie haben Ihr Ratenlimit überschritten.

Die ID der abzurufenden Remesh-Aufgabe.

Die ID der zu löschenden Remesh-Aufgabe.

Seitennummer für die Paginierung.

Begrenzung der Seitengröße. Maximal zulässig sind 50 Elemente.

Feld, nach dem sortiert werden soll.

Verfügbare Werte:

• +created_at: Nach Erstellungszeit in aufsteigender Reihenfolge sortieren.
• -created_at: Nach Erstellungszeit in absteigender Reihenfolge sortieren.

Eindeutige Kennung der zu streamenden Remesh-Aufgabe.

Eindeutiger Bezeichner für die Aufgabe. Obwohl wir als Implementierungsdetail eine k-sortierbare UUID für Aufgaben-IDs verwenden, solltest du keine Annahmen über das Format der ID treffen.

Typ der Remesh-Aufgabe. Der Wert ist remesh.

Herunterladbare URL zur von Meshy generierten texturierten 3D-Modelldatei. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht generiert wurde, anstatt eine leere Zeichenkette zurückzugeben.

Herunterladbare URL zu einem Vorschaubild, das aus dem neu vernetzten Modell gerendert wurde.

Herunterladbare URL zu einer Version von thumbnail_url mit transparentem Hintergrund (RGBA). Nur vorhanden, wenn die Aufgabe mit alpha_thumbnail: true erstellt wurde und die transparente Vorschau erfolgreich gerendert wurde; andernfalls wird dieses Feld weggelassen.

Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald die Aufgabe erfolgreich abgeschlossen wurde, wird sie zu 100.

Status der Aufgabe. Mögliche Werte sind einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Die Anzahl der vorhergehenden Aufgaben.

Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0.

Zeitstempel, wann die Aufgabe abgeschlossen wurde, in Millisekunden. Wenn die Aufgabe noch nicht abgeschlossen wurde, ist diese Eigenschaft 0.

Fehlerdetails für fehlgeschlagene Aufgaben. Siehe Fehler für die vollständige task_error-Objektreferenz.

Die Anzahl der von dieser Aufgabe verbrauchten Credits. Vorhanden, wenn der Aufgabenstatus PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt bei FAILED-Aufgaben 0 zurück (Credits werden bei einem Fehlschlag erstattet).