Druckbarkeit reparieren API

Erforderlich, sofern Sie nicht model_url senden. Die ID der Aufgabe, deren Modell Sie reparieren möchten, zum Beispiel eine Bild zu 3D-, Multi-Bild zu 3D-, Text zu 3D-, Neuvernetzung-, Neutexturierung- oder Druckbarkeit analysieren-Aufgabe. Die Aufgabe muss eine sein, die Sie mit der API erstellt haben, mit dem Status SUCCEEDED und einem GLB-Modell.

Eine Druckbarkeit-analysieren-Aufgabe, die die Wandstärke geprüft hat, gibt auch ihren Drucker und ihre Größe weiter. Die Reparatur prüft dann die Wandstärke und verstärkt dünne Wände, selbst wenn Sie keines von beidem senden. Ein von Ihnen gesendeter printer_type oder eine gesendete Druckgröße ersetzt den/die Wert(e) aus der Analyse. Eine Druckbarkeit-analysieren-Aufgabe einer .stl-, .fbx- oder .gltf-Datei aus model_url funktioniert nicht. Senden Sie diese Datei stattdessen als model_url.

Erforderlich, sofern Sie nicht input_task_id senden. Das zu reparierende Modell, als öffentliche URL oder als Data URI. Wenn Sie beides senden, verwendet Meshy input_task_id.

Bei einer http- oder https-URL muss das Modell eine .glb-, .gltf-, .obj-, .fbx- oder .stl-Datei von höchstens 400 MB sein. Eine Data URI kann nur eine base64-GLB- (data:model/gltf-binary;base64,...) oder glTF-Datei (data:model/gltf+json;base64,...) von höchstens 100 MB enthalten. Senden Sie eine .obj-, .fbx- oder .stl-Datei als http- oder https-URL.

Eine Datei über 100 MB muss zusätzlich diese Regeln erfüllen:

• Eine GLB-, glTF-, FBX- oder OBJ-Datei darf höchstens 10.000.000 Flächen haben. Meshy zählt Flächen als Dreiecke, sodass ein Viereck als 2 zählt und ein mehrfach gezeichnetes Netz einmal pro Kopie zählt.
• Eine FBX-Datei muss binäres FBX 7.1 oder neuer sein.
• Eine GLB- oder glTF-Datei darf keine Draco-Komprimierung verwenden.

Eine Meshy-Download-URL (assets.meshy.ai/…?Expires=…&Signature=…) ist signiert und funktioniert ab expires_at ihrer Aufgabe nicht mehr. Das erneute Abrufen der Aufgabe erneuert sie nicht. Senden Sie für ein mit Meshy erstelltes Modell stattdessen input_task_id, was funktioniert, solange Meshy die Quellaufgabe aufbewahrt (siehe Aufbewahrung von Assets). Um das Modell danach weiter zu verwenden, laden Sie es vor expires_at herunter und senden Sie Ihre eigene Kopie.

Ob zusätzlich eine Vorschau mit transparentem Hintergrund (RGBA) gerendert werden soll, die beim Abrufen der Aufgabe in alpha_thumbnail_url zurückgegeben wird. thumbnail_url ändert sich nicht.

Der Drucker, den Sie verwenden möchten. Er legt die Mindestwandstärke fest, die die Reparatur anstrebt. Wenn Sie eine Druckgröße ohne printer_type senden, verwendet Meshy fdm, sofern nicht eine Druckbarkeit-analysieren-Aufgabe in input_task_id den Drucker bereitstellt.

Verfügbare Werte:

• fdm: Filament, 1,0 mm Mindestwandstärke
• sla: Harz, 0,8 mm Mindestwandstärke
• full_color: Vollfarbe, 2,0 mm Mindestwandstärke

Jeder andere Wert ergibt 400.

Die Höhe des Drucks in Millimetern, von 1 bis 1000. Ein Wert außerhalb dieses Bereichs ergibt 400. Senden Sie dies oder intended_print_longest_side_mm, nicht beides.

Es funktioniert nur mit GLB-Eingabe. Senden Sie für eine model_url, die keine .glb-Datei ist, stattdessen intended_print_longest_side_mm.

Die Länge der längsten Seite des Drucks in Millimetern, von 1 bis 1000. Ein Wert außerhalb dieses Bereichs ergibt 400. Es funktioniert mit jedem Eingabeformat.

Die Anfrage kann nicht ausgeführt werden. Die Fehlermeldung gibt an, welches Problem gefunden wurde. Zum Beispiel:

• Fehlender Parameter: Weder input_task_id noch model_url wurde gesendet.
• Ungültige UUID: input_task_id ist keine gültige UUID.
• Ungültige Modell-URL: model_url ist fehlerhaft formatiert, verwendet ein nicht unterstütztes Schema oder hat eine nicht unterstützte Dateiendung.
• Modelldatei zu groß: Die Datei unter model_url ist bei einer http- oder https-URL größer als 400 MB oder als Data URI größer als 100 MB.
• Zu viele Flächen: Die Datei unter model_url ist eine GLB-, glTF-, FBX- oder OBJ-Datei über 100 MB mit mehr als 10.000.000 Flächen. Reduzieren Sie die Flächenanzahl und senden Sie die Datei erneut.
• ASCII-FBX über 100 MB: Die Datei unter model_url ist eine ASCII-FBX-Datei über 100 MB. Senden Sie sie als binäre FBX- oder GLB-Datei.
• Nicht lesbare Modelldatei: Die Datei unter model_url ist über 100 MB, und Meshy kann ihren Header nicht lesen. Zum Beispiel handelt es sich um eine Draco-komprimierte GLB- oder glTF-Datei oder eine binäre FBX-Datei älter als 7.1.
• Modell-Header zu komplex: Die Datei unter model_url ist über 100 MB, und ihr Header enthält zu viele Netze, Knoten oder Einträge zum Prüfen. Reduzieren Sie die Anzahl der Objekte in der Datei und senden Sie sie erneut.
• Modelldatei kann nicht heruntergeladen werden: model_url gab einen Fehler zurück, meist weil eine signierte Meshy-Download-URL abgelaufen ist. Das erneute Abrufen der Aufgabe liefert dieselbe URL mit derselben Ablaufzeit. Senden Sie Ihre eigene Kopie der Datei oder senden Sie input_task_id, solange Meshy die Quellaufgabe aufbewahrt.
• Aufgabe nicht erfolgreich: Die Aufgabe unter input_task_id ist noch ausstehend, in Bearbeitung oder fehlgeschlagen.
• Fehlendes GLB: Die Aufgabe unter input_task_id hat kein zu reparierendes GLB-Modell.
• Ungültige Druckgröße: intended_print_height_mm oder intended_print_longest_side_mm liegt außerhalb von 1 bis 1000, oder die Anfrage enthält beide.
• Unbekannter Druckertyp: printer_type ist nicht fdm, sla oder full_color.
• Höhe bei einem Nicht-GLB-Modell: Die Anfrage enthält intended_print_height_mm und eine model_url, die keine .glb-Datei ist. Senden Sie stattdessen intended_print_longest_side_mm.
• Dieses Modell kann nicht nach Höhe skaliert werden: Bei der angeforderten Höhe oder der Standardhöhe von 150 mm läge die längste Seite des Modells außerhalb von 1 bis 1.000 mm. Dies tritt auch auf, wenn das Modell flach ist oder Meshy seine Größe nicht bestimmen kann. Senden Sie stattdessen intended_print_longest_side_mm. Bei einer model_url im .glb-Format und manchen input_task_id-Aufgaben stellt Meshy dies erst fest, nachdem die Aufgabe gestartet ist, und die Aufgabe endet stattdessen mit FAILED.
• STL-Größe nicht verwendbar: Die Anfrage enthält printer_type ohne Größe, und Meshy kann die eigene längste Seite der .stl-Datei nicht lesen, oder sie liegt außerhalb von 1 bis 1.000 mm. Senden Sie intended_print_longest_side_mm.

Korrigieren Sie die Anfrage und senden Sie sie erneut. Siehe Fehler.

Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den Authorization-Header.

Zum Beispiel:

• Unzureichende Credits: Das Konto hat nicht genug Credits für diese Aufgabe, oder das Konto hat ein Credit-Limit erreicht. Prüfen Sie Ihr Guthaben und versuchen Sie es erneut.
• Kostenloser Plan: Das Erstellen einer Aufgabe erfordert einen kostenpflichtigen Plan. Aktualisieren Sie Ihren Plan in Ihren Abonnement-Einstellungen und versuchen Sie es erneut.

input_task_id ist ein Flachrelief-Modell, das dieser Endpunkt nicht reparieren kann. Die Meldung lautet This model type does not support this operation. Senden Sie ein anderes Modell.

Die Aufgabe unter input_task_id existiert nicht oder gehört einem anderen Benutzer. Überprüfen Sie die ID und verwenden Sie einen API-Schlüssel des Kontos, das die Aufgabe erstellt hat.

Sie haben Ihre Ratenbegrenzung überschritten oder haben zu viele ausstehende Aufgaben. Warten Sie und versuchen Sie es erneut. Siehe Ratenbegrenzungen.

Die Task-ID aus der Erstellungsantwort.

Die ID der zu löschenden Aufgabe.

Die zurückzugebende Seitenzahl, beginnend bei 1.

Die Anzahl der Aufgaben pro Seite, bis zu 100.

Die Sortierreihenfolge.

Verfügbare Werte:

• +created_at: älteste zuerst
• -created_at: neueste zuerst

Die Task-ID aus der Antwort der Erstellung.

Die Task-ID. Behandeln Sie sie als undurchsichtige Zeichenkette und verlassen Sie sich nicht auf ihr Format.

Der Task-Typ, immer print-repair.

Der Task-Status, einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED oder CANCELED.

Wie viel von der Aufgabe erledigt ist, in Prozent. Der Wert ist 0, bis die Aufgabe startet, und 100, wenn sie erfolgreich ist.

Die Anzahl der Aufgaben, die in der Warteschlange vor dieser liegen. Der Wert ist nur aussagekräftig, solange die Aufgabe PENDING ist.

Zeitpunkt, zu dem die Aufgabe erstellt wurde, in Unix-Millisekunden.

Zeitpunkt, zu dem die Aufgabe gestartet wurde, in Unix-Millisekunden. Der Wert ist 0, bis die Aufgabe startet.

Zeitpunkt, zu dem die Aufgabe beendet wurde, in Unix-Millisekunden. Der Wert ist 0, bis die Aufgabe beendet ist.

Zeitpunkt, zu dem das Ergebnis der Aufgabe abläuft, in Unix-Millisekunden. Der Wert ist 0, bis die Aufgabe beendet ist.

Die Fehlerdetails, wenn die Aufgabe fehlschlägt. Der Wert ist null, wenn die Aufgabe nicht fehlgeschlagen ist. Siehe Fehler.

Download-URLs für das reparierte Modell. Es enthält nur den Schlüssel, der dem Eingabeformat entspricht. Ein Format, das die Aufgabe nicht erzeugt hat, hat keinen Schlüssel, statt einer leeren Zeichenkette.

Download-URL für ein Vorschaubild des reparierten Modells.

Download-URL für eine Version von thumbnail_url mit transparentem Hintergrund (RGBA). Nur vorhanden, wenn Sie die Aufgabe mit alpha_thumbnail: true erstellt haben und Meshy die transparente Vorschau gerendert hat.

Immer ein leeres Array. Die Reparatur behält nur die Eingabe-Geometrie bei und backt Texturen nicht neu.

Die Anzahl der von der Aufgabe verbrauchten Credits. Der Wert ist 10, wenn die Aufgabe SUCCEEDED ist, und 0 bei einer FAILED-Aufgabe, da Meshy die Credits erstattet, wenn eine Aufgabe fehlschlägt.

Der Drucker und die Größe, die die Reparatur verwendet hat, unabhängig davon, ob Sie diese gesendet haben oder Meshy sie aus einer Analyze-Printability-Aufgabe übernommen hat. Bei einer Wandstärken-Reparatur von Anfang an vorhanden, auch während die Aufgabe PENDING ist. Ein Wert, den Meshy noch nicht kennt, ist null.

Was die Wandstärken-Reparatur getan hat. Vorhanden, nachdem eine Wandstärken-Reparatur erfolgreich war.