Neuvernetzung-API

Die ID der abgeschlossenen Bild-zu-3D- oder Text-zu-3D-Aufgabe, die Sie neu vernetzen möchten. Diese Aufgabe muss eine der folgenden sein: Text zu 3D Preview, Text zu 3D Refine, Bild zu 3D oder Neutexturierung. Zudem muss sie den Status SUCCEEDED haben.

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

Für Data URIs verwenden Sie den MIME-Typ: application/octet-stream.

Eine Liste von Zielformaten für das neu vernetzte Modell. Wenn nicht angegeben, wird nur GLB generiert.

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

Geben Sie die topology des generierten Modells an.

Verfügbare Werte:

• quad: Erzeugt ein überwiegend aus Quads bestehendes Netz.
• triangle: Erzeugt ein dezimiertes Dreiecksnetz.

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 Nutzerstufe:

• 100 bis 300.000 (einschließlich)

Aktivieren Sie die adaptive Dezimierung durch Festlegen einer Polygonanzahl-Stufe. Wenn gesetzt, wird target_polycount ignoriert.

Verfügbare Werte:

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

Ändert die Größe des Modells auf eine bestimmte Höhe in Metern. Wir empfehlen, stattdessen die dedizierte Resize API zu verwenden.

Ändert die Größe des Modells so, dass die längste Bounding-Box-Dimension dem angegebenen Wert in Metern entspricht. Wir empfehlen, stattdessen die dedizierte Resize API zu verwenden.

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

Wenn true, ändert der Dienst nur das Format der Eingabemodell-Datei und ignoriert andere Eingaben wie topology, resize_height und target_polycount. Wir empfehlen, stattdessen die dedizierte Convert API zu verwenden.

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 bestehende Feld thumbnail_url bleibt unverändert.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Es muss entweder model_url oder input_task_id angegeben werden.
• Ungültige Eingabeaufgabe: input_task_id muss sich auf eine erfolgreiche Aufgabe eines unterstützten Modells beziehen.
• Ungültiges Modellformat: model_url verweist auf eine Datei mit nicht unterstützter Erweiterung.
• Nicht erreichbare URL: model_url konnte nicht herunterladen werden.
• Ungültige topology: Der Parameter topology ist ungültig.
• Sich gegenseitig ausschließende Parameter: auto_size und resize_height können nicht beide gesetzt werden.

Die Authentifizierung ist fehlgeschlagen. Bitte überprüfen Sie Ihren API-Schlüssel.

Unzureichende Credits, um diese Aufgabe auszuführen.

Sie haben Ihre Ratenbegrenzung überschritten.

Die ID des abzurufenden Neuvernetzungs-Tasks.

Die ID der zu löschenden Neuvernetzungsaufgabe.

Seitennummer für die Paginierung.

Begrenzung der Seitengröße. Maximal erlaubt sind 100 Elemente.

Feld, nach dem sortiert werden soll.

Verfügbare Werte:

• +created_at: Sortierung nach Erstellungszeitpunkt in aufsteigender Reihenfolge.
• -created_at: Sortierung nach Erstellungszeitpunkt in absteigender Reihenfolge.

Eindeutige Kennung der zu streamenden Neuvernetzungs-Aufgabe.

Eindeutige Kennung für den Task. Obwohl wir als Implementierungsdetail eine k-sortierbare UUID für Task-IDs verwenden, sollten Sie keine Annahmen über das Format der ID treffen.

Typ des Remesh-Tasks. Der Wert ist remesh.

Herunterladbare URL zur texturierten 3D-Modelldatei, die von Meshy generiert wurde. Die Eigenschaft für ein Format wird ausgelassen, wenn das Format nicht generiert wurde, anstatt einen leeren String 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 der Task mit alpha_thumbnail: true erstellt wurde und die transparente Vorschau erfolgreich gerendert wurde; andernfalls wird dieses Feld ausgelassen.

Fortschritt des Tasks. Wenn der Task noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald der Task erfolgreich abgeschlossen wurde, wird dieser Wert 100.

Status des Tasks. Mögliche Werte sind PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Die Anzahl der vorangehenden Tasks.

Zeitstempel, wann der Task erstellt wurde, in Millisekunden.

Zeitstempel, wann der Task gestartet wurde, in Millisekunden. Wenn der Task noch nicht gestartet wurde, ist diese Eigenschaft 0.

Zeitstempel, wann der Task abgeschlossen wurde, in Millisekunden. Wenn der Task noch nicht abgeschlossen ist, ist diese Eigenschaft 0.

Fehlerdetails für fehlgeschlagene Tasks. Siehe Fehler für die vollständige Referenz des task_error-Objekts.

Die Anzahl der von diesem Task verbrauchten Credits. Vorhanden, wenn der Task-Status PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt 0 für FAILED-Tasks zurück (Credits werden bei einem Fehlschlag zurückerstattet).