Druckbarkeit analysieren API

Überprüfen Sie ein 3D-Modell auf Druckprobleme, indem Sie dessen Wasserdichtigkeit, Volumen, Löcher, nicht-mannigfaltige Kanten und entartete Flächen messen. Sie können außerdem die Wandstärke bei der geplanten Druckgröße überprüfen.

POST/openapi/v1/print/analyze

Erstellen einer Druckbarkeit analysieren-Aufgabe

Erstellt eine Aufgabe zum Druckbarkeit analysieren, die ein 3D-Modell bewertet und dessen Druckbarkeitsmetriken ausgibt. Die Aufgabe läuft im Hintergrund. Wie lange eine Aufgabe üblicherweise dauert, erfahren Sie unter Verarbeitungszeiten.

Wenn Meshy für die Aufgabe input_task_id bereits ein Druckbarkeitsergebnis besitzt, ist die neue Aufgabe sofort fertig. Ihr erstes GET darauf liefert bereits das Ergebnis.

Request

POST

/openapi/v1/print/analyze

# Analyze an existing task
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or analyze a model URL directly
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb"
  }'

# Also check wall thickness for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

Parameter

Name
input_task_id
Type
string
Erforderlich
Description
Erforderlich, sofern Sie nicht model_url senden. Die ID der Aufgabe, deren Modell analysiert werden soll. Die Aufgabe muss den Status SUCCEEDED haben und entweder Ihnen gehören oder in einem Arbeitsbereich liegen, dem Sie angehören.
Es kann einer dieser Aufgabentypen sein, erstellt mit Meshy 6 oder neuer, einschließlich Meshy 7:
Auch eine Druckbarkeit reparieren-Aufgabe funktioniert.

Name
model_url
Type
string
Erforderlich
Description
Erforderlich, sofern Sie nicht input_task_id senden. Das zu analysierende 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. Ein Data URI kann nur eine base64-GLB-Datei (data:model/gltf-binary;base64,...) oder eine 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 außerdem 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 pro Kopie einmal zählt.
- Eine FBX-Datei muss binäres FBX 7.1 oder neuer sein.
- Eine GLB- oder glTF-Datei darf keine Draco-Kompression verwenden.
Eine Meshy-Download-URL (assets.meshy.ai/…?Expires=…&Signature=…) ist signiert und funktioniert ab expires_at der zugehörigen Aufgabe nicht mehr. Erneutes Abrufen der Aufgabe erneuert sie nicht. Für ein mit Meshy erstelltes Modell senden Sie 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.

Um zusätzlich die Wandstärke bei der geplanten Druckgröße zu prüfen, senden Sie printer_type, eine Druckgröße oder beides. Das Ergebnis befindet sich in printability.thin_walls. Die Prüfung der Wandstärke dauert länger, daher ist die Aufgabe meist nicht sofort fertig, selbst wenn Meshy das Modell bereits zuvor analysiert hat.

Name
printer_type
Type
string
Description
Der Drucker, den Sie verwenden möchten. Er legt die minimale Wandstärke für die Wandstärkenprüfung fest. Wenn Sie eine Druckgröße ohne printer_type senden, verwendet Meshy fdm.
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 liefert 400.
Name
intended_print_height_mm
Type
number
Description
Die Höhe des Drucks in Millimetern, von 1 bis 1000. Ein Wert außerhalb dieses Bereichs liefert 400. Senden Sie entweder dies oder intended_print_longest_side_mm, nicht beides.
Es funktioniert nur mit GLB-Eingaben. Für eine model_url, die keine .glb-Datei ist, senden Sie stattdessen intended_print_longest_side_mm.
Name
intended_print_longest_side_mm
Type
number
Description
Die Länge der längsten Seite des Drucks in Millimetern, von 1 bis 1000. Ein Wert außerhalb dieses Bereichs liefert 400. Es funktioniert mit jedem Eingabeformat.

Wenn Sie printer_type ohne Größe senden, verwendet Meshy diese Druckgröße:

.glb-Datei oder beliebige input_task_id: 150 mm Höhe
.stl-Datei: die eigene längste Seite der Datei, gelesen als Millimeter
.obj-, .fbx- oder .gltf-Datei: 150 mm an der längsten Seite

Für eine STL-Datei in anderen Einheiten senden Sie intended_print_longest_side_mm.

Meshy rundet beide Druckgrößen auf den nächsten Millimeter.

Rückgabe

Das result-Feld der Antwort enthält die ID der neuen Druckbarkeit analysieren-Aufgabe.

Fehlermodi

Name
400 - Bad Request
Description
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 Dateierweiterung.
- Modelldatei zu groß: Die Datei unter model_url ist über 400 MB bei einer http- oder https-URL oder über 100 MB als Data URI.
- 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.
- Modelldatei nicht lesbar: Die Datei unter model_url ist über 100 MB, und Meshy kann deren Header nicht lesen. Zum Beispiel ist es 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 lieferte einen Fehler, meist weil eine signierte Meshy-Download-URL abgelaufen ist. Erneutes Abrufen der Aufgabe liefert dieselbe URL mit demselben Ablaufdatum. 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.
- 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.
- Modell kann nicht anhand der Höhe dimensioniert 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 dessen 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 nach dem Start der Aufgabe fest, und die Aufgabe endet stattdessen als FAILED.
- STL-Größe unbrauchbar: 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.
Name
401 - Unauthorized
Description
Der API-Schlüssel fehlt oder ist ungültig. Überprüfen Sie den Authorization-Header.
Name
403 - Forbidden
Description
input_task_id ist ein Bas-Relief-Modell, das dieser Endpunkt nicht analysieren kann. Die Meldung lautet This model type does not support this operation. Senden Sie ein anderes Modell.
Name
404 - Not Found
Description
Meshy kann für input_task_id kein zu analysierendes Modell finden. Zum Beispiel:
- Die Aufgabe existiert nicht, wurde gelöscht, oder gehört nicht Ihnen oder einem Arbeitsbereich, dem Sie angehören.
- Die Aufgabe verwendet ein Modell, das älter als Meshy 6 ist, oder ihr Typ erzeugt kein 3D-Modell.
- Die Modelldatei der Aufgabe befindet sich nicht mehr im Speicher.
Überprüfen Sie, ob input_task_id eine unterstützte Aufgabe ist, die Ihnen gehört oder in einem Ihrer Arbeitsbereiche liegt, oder senden Sie das Modell als model_url.
Name
429 - Too Many Requests
Description
Sie haben Ihre Ratenbegrenzung überschritten oder haben zu viele ausstehende Aufgaben. Warten Sie und versuchen Sie es erneut. Siehe Ratenbegrenzungen.

GET/openapi/v1/print/analyze/:id

Einen Druckbarkeit-analysieren-Task abrufen

Gibt einen Druckbarkeit-analysieren-Task anhand seiner ID zurück.

Request

GET

/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}

Parameter

Name
id
Type
path
Description
Die Task-ID aus der Erstellungsantwort.

Rückgabewerte

Das Druckbarkeit-analysieren-Task-Objekt. Das Feld printability ist erst vorhanden, wenn der Task SUCCEEDED ist. Wenn Meshy die Wandstärke geprüft hat, enthält printability zusätzlich intended_print und thin_walls.

DELETE/openapi/v1/print/analyze/:id

Eine Analyze-Printability-Aufgabe löschen

Löscht eine Aufgabe zur Druckbarkeitsanalyse dauerhaft, einschließlich ihres zwischengespeicherten Ergebnisses. Das Löschen kann nicht rückgängig gemacht werden.

Request

DELETE

/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
  "message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}

Pfadparameter

Name
id
Type
path
Description
Die ID der zu löschenden Aufgabe.

Aufgabenstatus

Das Löschen einer Aufgabe mit dem Status PENDING erstattet die Credits, die beim Erstellen der Aufgabe verwendet wurden.

Eine Aufgabe mit dem Status IN_PROGRESS kann nicht gelöscht werden. Die Anfrage gibt 409 Conflict zurück, und die Aufgabe läuft weiter. Meshy erstattet keine Aufgabe, die bereits gestartet wurde, sodass das Löschen sowohl die Credits als auch das Ergebnis kosten würde. Warten Sie, bis sie den Status SUCCEEDED, FAILED oder CANCELED erreicht, und löschen Sie sie dann.

Das Löschen einer Aufgabe in einem Endstatus (SUCCEEDED, FAILED oder CANCELED) erstattet ihre Credits nicht.

Rückgabe

200 OK, wenn die Aufgabe gelöscht wurde, oder 409 Conflict, wenn die Aufgabe IN_PROGRESS ist.

GET/openapi/v1/print/analyze

Liste der Druckbarkeit analysieren-Aufgaben

Gibt eine Liste Ihrer Druckbarkeit analysieren-Aufgaben zurück.

Request

GET

/openapi/v1/print/analyze

curl https://api.meshy.ai/openapi/v1/print/analyze?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-analyze",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "expires_at": 1715725401000,
    "task_error": null,
    "printability": {
      "_version": "v1",
      "status": "warning",
      "issue_count": 1,
      "error_count": 0,
      "warning_count": 1,
      "metrics": {
        "is_watertight": true,
        "volume": 1.316167354292668,
        "non_manifold_edges": 0,
        "degenerate_faces": 43242,
        "holes": 0
      },
      "evaluated_at": 1700000001000
    },
    "consumed_credits": 0
  }
]

Parameter

Name
page_num
Type
integer
Standard 1
Description
Die zurückzugebende Seitenzahl, beginnend bei 1.
Name
page_size
Type
integer
Standard 10
Description
Die Anzahl der Aufgaben pro Seite, bis zu 100.
Name
sort_by
Type
string
Description
Die Sortierreihenfolge.
Verfügbare Werte:
- +created_at: älteste zuerst
- -created_at: neueste zuerst

Rückgabe

Eine paginierte Liste von Druckbarkeit analysieren-Aufgabenobjekten.

GET/openapi/v1/print/analyze/:id/stream

Einen Analyze-Printability-Task streamen

Streamt die Aktualisierungen eines Analyze-Printability-Tasks als Server-Sent Events (SSE).

Request

GET

/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream

curl -N https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

Parameter

Name
id
Type
path
Description
Die Task-ID aus der Antwort der Erstellung.

Rückgabe

Ein Stream von Analyze-Printability-Task-Objekten als Server-Sent Events.

Jedes Event enthält das vollständige Task-Objekt, in derselben Form, die der Get-Endpunkt zurückgibt. Solange der Task PENDING oder IN_PROGRESS ist, sind seine Ausgabefelder leer (null, [] oder {}), und finished_at ist 0. Meshy sendet das Feld printability erst, nachdem der Task SUCCEEDED ist.

Das Analyze Printability-Taskobjekt

Ein Analyze Printability-Taskobjekt beschreibt eine Analyse eines 3D-Modells. Es enthält den Status, den progress und das Druckbarkeitsergebnis, sobald der Task erfolgreich war.

The Analyze Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

The Analyze Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}

Name
id
Type
string
Description
Die Task-ID. Behandeln Sie sie als undurchsichtige Zeichenkette und verlassen Sie sich nicht auf ihr Format.
Name
type
Type
string
Description
Der Task-Typ, immer print-analyze.
Name
status
Type
string
Description
Der Task-Status, einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED oder CANCELED.
Name
progress
Type
integer
Description
Wie viel vom Task erledigt ist, als Prozentsatz. Der Wert ist 0, bis der Task startet, und 100, wenn er erfolgreich ist.
Name
preceding_tasks
Type
integer
Description
Die Anzahl der Tasks, die in der Warteschlange vor diesem liegen. Der Wert ist nur aussagekräftig, solange der Task PENDING ist.
Name
created_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task erstellt wurde, in Unix-Millisekunden.
Name
started_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task gestartet ist, in Unix-Millisekunden. Der Wert ist 0, bis der Task startet.
Name
finished_at
Type
timestamp
Description
Zeitpunkt, zu dem der Task beendet wurde, in Unix-Millisekunden. Der Wert ist 0, bis der Task beendet ist.
Name
expires_at
Type
timestamp
Description
Zeitpunkt, zu dem das Ergebnis des Tasks abläuft, in Unix-Millisekunden. Der Wert ist 0, bis der Task beendet ist.
Name
task_error
Type
object
Description
Die Fehlerdetails, wenn der Task fehlschlägt. Der Wert ist null, wenn der Task nicht fehlgeschlagen ist. Siehe Fehler.
- Name
  message
  Type
  string
  Description
  Eine Beschreibung dessen, was schiefgelaufen ist.
Name
printability
Type
object
Description
Das Ergebnis der Analyse. Es ist erst vorhanden, wenn der Task SUCCEEDED ist.
- Name
  _version
  Type
  string
  Description
  Die Schemaversion des Druckbarkeitsergebnisses. Der Wert ist v1.
- Name
  status
  Type
  string
  Description
  Das Gesamturteil, eines von:
  
  healthy: keine Fehler und keine Warnungen
  
  warning: mindestens eine Warnung und keine Fehler
  
  error: mindestens ein Fehler
  
  unknown: Meshy konnte das Modell nicht analysieren
  
  Wenn Meshy die Wandstärke geprüft hat, ist dies der schlechtere Wert aus den Netzprüfungen und thin_walls.status. Von schlechtestem bis bestem Wert ist die Reihenfolge error, warning, unknown und healthy.
- Name
  issue_count
  Type
  integer
  Description
  Die Gesamtanzahl der Probleme, entspricht error_count + warning_count.
- Name
  error_count
  Type
  integer
  Description
  Die Anzahl der Probleme auf Fehlerebene. Meshy zählt für jedes der Folgenden einen Fehler:
  
  Das Modell ist nicht wasserdicht und hat mehr als 8 Löcher.
  
  Das Modell hat mehr als 8 Löcher.
  
  Das Volumen ist null oder kleiner.
  
  Das Modell hat mehr als 50 nicht-mannigfaltige Kanten.
  
  Wenn Meshy die Wandstärke geprüft hat, zählen zu dünne Wände (thin_walls.status ist error) als ein weiterer Fehler.
- Name
  warning_count
  Type
  integer
  Description
  Die Anzahl der Probleme auf Warnebene. Meshy zählt für jedes der Folgenden eine Warnung:
  
  Das Modell ist nicht wasserdicht und hat 8 oder weniger Löcher.
  
  Das Modell hat 1 bis 8 Löcher.
  
  Das Modell hat 1 bis 50 nicht-mannigfaltige Kanten.
  
  Das Modell hat entartete Flächen.
- Name
  metrics
  Type
  object
  Description
  Die rohen Geometriemessungen des Modells.
  Name
  is_watertight
  Type
  boolean
  Description
  true, wenn das Netz keine Randkanten hat, das heißt, wenn es geschlossen ist.
  Name
  volume
  Type
  number
  Description
  Das Volumen des Modells, in Kubikmetern.
  Name
  non_manifold_edges
  Type
  integer
  Description
  Die Anzahl der nicht-mannigfaltigen Kanten.
  Name
  degenerate_faces
  Type
  integer
  Description
  Die Anzahl der entarteten Flächen, also Flächen mit Fläche null oder ungültige Flächen.
  Name
  holes
  Type
  integer
  Description
  Die Anzahl der Löcher im Netz, gezählt als Randschleifen.
- Name
  intended_print
  Type
  object
  Description
  Der Drucker und die Größe, die bei der Wandstärkenprüfung verwendet wurden. Nur vorhanden, wenn Meshy die Wandstärke geprüft hat.
  Name
  printer_type
  Type
  string
  Description
  Der Druckertyp, fdm, sla oder full_color.
  Name
  height_mm
  Type
  number
  Description
  Die Druckhöhe in Millimetern, wenn die Größe des Drucks über die Höhe festgelegt wird. Andernfalls ist der Wert null.
  Name
  longest_side_mm
  Type
  number
  Description
  Die Länge der längsten Seite des Drucks in Millimetern. Wenn die Größe des Drucks über die Höhe festgelegt wird, berechnet Meshy diesen Wert aus den Proportionen des Modells.
  Name
  wall_thickness_mm
  Type
  number
  Description
  Die minimale Wandstärke für printer_type, in Millimetern. Meshy meldet dünnere Wände als zu dünn.
  Name
  dimensions_mm
  Type
  array
  Description
  Die [Breite, Tiefe, Höhe] des Drucks, in Millimetern. Die Höhe kann sich von height_mm um einen Bruchteil eines Millimeters unterscheiden. Der Wert ist null für andere Eingaben als GLB, oder wenn Meshy die Größe des Modells nicht bestimmen kann.
- Name
  thin_walls
  Type
  object
  Description
  Das Ergebnis der Wandstärkenprüfung. Nur vorhanden, wenn Meshy die Wandstärke geprüft hat.
  Name
  thin_area_ratio
  Type
  number
  Description
  Der Anteil der Oberfläche, der dünner als intended_print.wall_thickness_mm ist, von 0 bis 1. Der Wert ist null, wenn Meshy das Modell nicht vermessen konnte.
  Name
  has_thin_walls
  Type
  boolean
  Description
  true, wenn ein Teil der Oberfläche zu dünn ist. Scharfe Ecken allein können bereits true ergeben. Verwenden Sie daher status, um zu entscheiden, ob die Wände verdickt werden müssen. Der Wert ist null, wenn Meshy das Modell nicht vermessen konnte.
  Name
  status
  Type
  string
  Description
  Das Wandstärkenurteil, eines von:
  
  healthy: 5 % oder weniger der Oberfläche sind zu dünn.
  
  error: mehr als 5 % der Oberfläche sind zu dünn. Um die Wände zu verdicken, senden Sie die id dieses Tasks als input_task_id an Repair Printability. Wenn dieser Task eine .stl-, .fbx- oder .gltf-Datei aus model_url analysiert hat, senden Sie stattdessen diese Datei als model_url.
  
  unknown: Meshy konnte das Modell nicht vermessen. Wenn die Wandstärkenprüfung selbst fehlschlägt, endet der Task als FAILED.
- Name
  evaluated_at
  Type
  timestamp
  Description
  Zeitpunkt, zu dem Meshy die Analyse berechnet hat, in Unix-Millisekunden.
Name
consumed_credits
Type
integer
Description
Die Anzahl der Credits, die der Task verbraucht hat. Der Wert ist immer 0, da die Analyse kostenlos ist.