Neuvernetzung-API

Die ID der abgeschlossenen Bild-zu-3D- oder Text-zu-3D-Aufgabe, die neu vernetzt werden soll. Diese Aufgabe muss eine der folgenden 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 zur Neuvernetzung über eine öffentlich zugängliche URL oder Data URI bereit. Unterstützte Formate: .glb, .gltf, .obj, .fbx, .stl.

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

Maximale Dateigröße: 100 MB.

Eine Liste der Zielformate für das neu vernetzte Modell. Wird dieser Parameter weggelassen, wird nur GLB erzeugt.

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

Legt die topology des generierten Modells fest.

Verfügbare Werte:

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

Legt die Ziel-Polygonanzahl des generierten Modells fest. Die tatsächliche Polygonanzahl kann je nach Komplexität der Geometrie vom Zielwert abweichen.

Der gültige Wertebereich hängt von der Nutzerstufe ab:

• 100 bis 300.000 (einschließlich)

Aktiviert die adaptive Dezimierung durch Festlegen einer Polygonanzahl-Stufe. 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.

Ä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 Seite der Bounding-Box dem angegebenen Wert in Metern entspricht. Wir empfehlen stattdessen die dedizierte Resize API zu verwenden.

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

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 dedizierte Convert API zu verwenden.

Wenn auf true gesetzt, rendert die Aufgabe zusätzlich eine Version der Vorschau mit transparentem Hintergrund (RGBA) und gibt diese als alpha_thumbnail_url in der GET-Antwort zurück. Das bestehende 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 Eingabe-Aufgabe: 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 Dateierweiterung.
• Nicht erreichbare URL: model_url konnte nicht heruntergeladen werden.
• Modelldatei zu groß: Die Datei unter model_url überschreitet 100 MB.
• 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.

Nicht genügend 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).