Remesh-API

Die ID der abgeschlossenen Bild zu 3D oder Text zu 3D Aufgabe, die Sie remeshen möchten. Diese Aufgabe muss eine der folgenden Aufgaben sein: Text zu 3D Vorschau, Text zu 3D Verfeinerung, Bild zu 3D oder Neutexturierung. Außerdem muss sie den Status SUCCEEDED haben.

Bitte stellen Sie ein 3D-Modell für Meshy über eine öffentlich zugängliche URL oder Data URI zur Verfügung. 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 remeshte Modell. Wenn weggelassen, 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: Erzeugt ein quad-dominantes 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 von der Zielvorgabe abweichen.

Der gültige Wertebereich variiert je nach Nutzerstufe:

• 100 bis 300.000 (einschließlich)

Aktivieren Sie die adaptive Dezimierung, indem Sie ein Polygonanzahl-Level festlegen. Wenn gesetzt, 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 die Verwendung der dedizierten Resize API.

Ändern Sie die Größe des Modells so, dass die längste Dimension der Begrenzungsbox dem angegebenen Wert in Metern entspricht. Wir empfehlen 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 das Modell entsprechend zu skalieren. Wir empfehlen die Verwendung der dedizierten Resize API.

Wenn true, ändert der Dienst nur das Format der Eingabemodell-Datei und ignoriert andere Eingaben wie topology, resize_height und target_polycount. Wir empfehlen 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 als alpha_thumbnail_url in der GET-Antwort zurück. Das bestehende thumbnail_url-Feld 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 sich auf eine erfolgreiche Aufgabe aus einem unterstützten Modell beziehen.
• 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 topology-Parameter ist ungültig.
• Gegenseitig ausschließende Parameter: auto_size und resize_height können nicht beide gesetzt werden.

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

Nicht genügend Credits, um diese Aufgabe auszuführen.

Sie haben Ihre Ratenbegrenzung überschritten.

Die ID der abzurufenden Neuvernetzung-Aufgabe.

Die ID der zu löschenden Neuvernetzung-Aufgabe.

Seitennummer für die Paginierung.

Seitengrößenlimit. Maximal erlaubt sind 50 Elemente.

Feld, nach dem sortiert werden soll.

Verfügbare Werte:

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

Eindeutiger Bezeichner für die Neuvernetzung-Aufgabe, die gestreamt werden soll.

Eindeutiger Bezeichner für die Aufgabe. Während wir eine k-sortierbare UUID für Aufgaben-IDs als Implementierungsdetail verwenden, sollten Sie keine Annahmen über das Format der ID machen.

Typ der Remesh-Aufgabe. Der Wert ist remesh.

Herunterladbare URL zur texturierten 3D-Modell-Datei, die von Meshy generiert wurde. Die Eigenschaft für ein Format wird weggelassen, wenn das Format nicht generiert wird, 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 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, hat diese Eigenschaft den Wert 0. Sobald die Aufgabe erfolgreich abgeschlossen ist, wird dieser Wert 100.

Status der Aufgabe. Mögliche Werte sind 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, hat diese Eigenschaft den Wert 0.

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

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

Die Anzahl der Credits, die von dieser Aufgabe verbraucht wurden. Vorhanden, wenn der Aufgabenstatus PENDING, IN_PROGRESS oder SUCCEEDED ist. Gibt 0 für FAILED-Aufgaben zurück (Credits werden bei einem Fehler zurückerstattet).