Druckbarkeit reparieren API

Die ID einer erfolgreich abgeschlossenen Aufgabe, die Ihnen gehört. Unterstützte Aufgabentypen: Bild zu 3D, Multi-Bild zu 3D, Text zu 3D, Neuvernetzung, Neutexturierung und Druckbarkeit analysieren. Die Aufgabe muss den Status SUCCEEDED haben und muss ein GLB-Asset erzeugt haben.

Eine Analyseaufgabe, die die Wandstärke geprüft hat, gibt auch ihren Drucker und ihre Größe weiter, sodass die Reparatur die Wandstärke prüft und dünne Wände verdickt, selbst wenn Sie keine dieser Angaben senden; ein von Ihnen gesendeter printer_type oder eine gesendete Druckgröße überschreiben diesen Wert. Analyseaufgaben, die aus einer model_url mit .stl, .fbx oder .gltf erstellt wurden, werden nicht akzeptiert: Senden Sie die Datei stattdessen als model_url.

URL eines zu reparierenden 3D-Modells. Unterstützte Formate: .glb, .gltf, .obj, .fbx, .stl. Maximale Dateigröße: 100 MB. Muss http, https oder eine data:-URL verwenden (data-URLs umgehen die Prüfung der Dateiendung).

Meshy-Download-URLs (assets.meshy.ai/…?Expires=…&Signature=…) sind signiert und funktionieren ab expires_at der Aufgabe nicht mehr; ein erneutes Abrufen der Aufgabe erneuert sie nicht. Für ein mit Meshy generiertes Modell übergeben Sie stattdessen input_task_id. Dies funktioniert, solange die Quellaufgabe aufbewahrt wird (siehe Aufbewahrung von Assets). Um ein Modell danach weiterzuverwenden, laden Sie es vor expires_at herunter und senden Sie Ihre eigene Kopie.

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.

Der Drucker, den Sie verwenden möchten. Er legt die minimale Wandstärke fest, auf die die Reparatur abzielt. Standardmäßig fdm, wenn Sie eine Druckgröße ohne diesen Parameter senden, es sei denn, eine als input_task_id übergebene Analyseaufgabe liefert den Drucker.

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.

Höhe des Drucks, in Millimetern. Bereich: [1, 1000]. Wird auf den nächsten Millimeter gerundet. Nur für GLB-Eingaben.

Länge der längsten Seite des Drucks, in Millimetern. Bereich: [1, 1000]. Wird auf den nächsten Millimeter gerundet. Funktioniert mit jedem Eingabeformat.

Die Anfrage war nicht akzeptabel. Häufige Ursachen:

• Fehlender Parameter: Weder input_task_id noch model_url wurden angegeben.
• 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ß: Der Inhalt von model_url überschritt 100 MB.
• Modelldatei konnte nicht heruntergeladen werden: model_url lieferte einen Fehler zurück, meist weil eine signierte Meshy-Download-URL abgelaufen ist. Ein erneutes Abrufen der Aufgabe liefert dieselbe URL mit demselben Ablaufdatum zurück. Senden Sie daher Ihre eigene Kopie der Datei oder verwenden Sie input_task_id, solange die Quellaufgabe noch aufbewahrt wird.
• Aufgabe nicht erfolgreich: Die referenzierte Aufgabe befindet sich noch in Bearbeitung, wartet oder ist fehlgeschlagen.
• Fehlendes GLB: Die referenzierte Aufgabe hat kein zu reparierendes GLB-Asset.
• Ungültige Druckgröße: intended_print_height_mm oder intended_print_longest_side_mm liegt außerhalb von [1, 1000], oder beide wurden gesendet.
• Unbekannter Druckertyp: printer_type ist nicht fdm, sla oder full_color.
• Höhe bei einem Nicht-GLB-Modell: intended_print_height_mm wurde mit einer model_url gesendet, die nicht .glb ist. Verwenden Sie stattdessen intended_print_longest_side_mm.
• Dieses Modell kann nicht über die Höhe bemessen 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, 1000] mm, das Modell ist flach, oder seine Größe kann nicht bestimmt werden. Verwenden Sie stattdessen intended_print_longest_side_mm. Bei einer model_url im Format .glb sowie bei manchen input_task_id-Aufgaben wird dies erst nach Start der Aufgabe erkannt, und die Aufgabe endet dann mit FAILED.
• STL-Größe unbrauchbar: printer_type wurde ohne Größenangabe gesendet, und die eigene längste Seite der .stl-Datei kann nicht gelesen werden oder liegt außerhalb von [1, 1000] mm. Senden Sie intended_print_longest_side_mm.

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

Häufige Ursachen:

• Kostenloser Plan: Das Erstellen von Aufgaben erfordert einen kostenpflichtigen Plan. Upgraden Sie auf der Abonnement-Seite.
• Unzureichende Credits: Das Credit-Limit des Arbeitsbereichs wurde erreicht.

Die referenzierte Aufgabe existiert nicht oder gehört einem anderen Benutzer.

Sie haben Ihr Kontingent an ausstehenden Aufgaben oder Ihre Ratenbegrenzung überschritten.

Die ID der abzurufenden Aufgabe zur Druckbarkeitsreparatur.

Die ID der zu löschenden Aufgabe zur Druckbarkeit reparieren.

Seitenzahl für die Paginierung. Beginnt bei und ist standardmäßig 1.

Seitengrößenbeschränkung. Standardmäßig 10 Einträge. Maximal zulässig sind 100 Einträge.

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.

Eindeutige Kennung der Aufgabe zur Reparatur der Druckbarkeit, die gestreamt werden soll.

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

Typ des Repair-Printability-Tasks. Der Wert ist print-repair.

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

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

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 beendet wurde, in Millisekunden. Wenn der Task noch nicht beendet ist, ist diese Eigenschaft 0.

Zeitstempel, wann das Task-Ergebnis im System abläuft, in Millisekunden. 0, wenn der Task noch nicht abgeschlossen ist.

Fehlerinformationen, falls der Task fehlgeschlagen ist. Diese Eigenschaft ist null, wenn der Task nicht fehlgeschlagen ist. Weitere Details findest du unter Fehler.

Herunterladbare URLs zum reparierten 3D-Modell. Nur das Feld, das dem Eingabeformat entspricht, wird befüllt; die anderen Formatfelder sind leere Zeichenketten.

URL eines Vorschaubilds, das aus dem reparierten 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 weggelassen.

Immer ein leeres Array. Die Reparatur erhält nur die Eingabegeometrie und backt keine Texturen neu.

Die Anzahl der von diesem Task verbrauchten Credits. 10, sobald der Task den Status SUCCEEDED erreicht hat. Gibt bei FAILED-Tasks 0 zurück (Credits werden bei einem Fehlschlag erstattet).

Der Drucker und die Größe, die bei der Reparatur verwendet wurden, egal ob sie gesendet oder von einem Analyze-Task übernommen wurden. Bei einer Wandstärken-Reparatur von Anfang an vorhanden (PENDING); noch nicht bekannte Werte sind null.

Was die Wandstärken-Reparatur bewirkt hat. Vorhanden, sobald eine Wandstärken-Reparatur erfolgreich war.