Druckbarkeit reparieren API

Reparieren Sie ein 3D-Modell für die FDM-Druckbarkeit — beheben Sie nicht-mannigfaltige Kanten, entartete Flächen, Löcher und andere Topologieprobleme, damit das Netz druckbereit ist.

POST/openapi/v1/print/repair

Erstellen einer Druckbarkeit-Reparaturaufgabe

Dieser Endpunkt erstellt eine neue Druckbarkeit-Reparaturaufgabe. Die Aufgabe führt eine Topologie-Reparatur an einem 3D-Modell durch und liefert eine wasserdichte, druckfertige Version zurück.

Das Ausgabeformat entspricht dem Eingabeformat. Wenn Sie eine .stl über model_url einreichen, enthält die Antwort model_urls.stl das reparierte Netz, und die anderen Formatfelder bleiben leer. Der input_task_id-Pfad liest immer die GLB der Quellaufgabe, sodass die Ausgabe .glb ist.

Parameter

Nur einer von input_task_id oder model_url ist erforderlich. Wenn beide angegeben sind, hat input_task_id Vorrang.

Vorhandene Texturen werden während der Reparatur aufgrund von Geometrieänderungen entfernt. Um Texturen wieder hinzuzufügen, verwenden Sie die Retexture API auf dem reparierten Modell.

  • Name
    model_url
    Type
    string
    Erforderlich
    Description

    URL eines 3D-Modells zur Reparatur. Unterstützte Formate: .glb, .gltf, .obj, .fbx, .stl. Maximale Dateigröße: 100 MB. Muss http, https oder eine data: URL verwenden (Daten-URLs umgehen Erweiterungsprüfungen).

  • Name
    alpha_thumbnail
    Type
    boolean
    Standard false
    Description

    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.

Rückgaben

Die result-Eigenschaft der Antwort enthält die id der neu erstellten Druckbarkeit-Reparaturaufgabe.

Fehlermodi

  • Name
    400 - Bad Request
    Description

    Die Anfrage war nicht akzeptabel. Häufige Ursachen:

    • Fehlender Parameter: weder input_task_id noch model_url wurde angegeben.
    • Ungültige UUID: input_task_id ist keine gültige UUID.
    • Ungültige Modell-URL: model_url ist fehlerhaft, verwendet ein nicht unterstütztes Schema oder hat eine nicht unterstützte Dateierweiterung.
    • Modell-Datei zu groß: model_url-Inhalt überschritt 100 MB.
    • Aufgabe nicht erfolgreich: die referenzierte Aufgabe ist noch ausstehend, in Bearbeitung oder fehlgeschlagen.
    • Fehlendes GLB: die referenzierte Aufgabe hat kein GLB-Asset zur Reparatur.
  • Name
    401 - Unauthorized
    Description

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

  • Name
    402 - Payment Required
    Description

    Häufige Ursachen:

    • Kostenloser Plan: Die Aufgabenerstellung erfordert einen kostenpflichtigen Plan. Upgrade auf der Abonnementseite.
    • Unzureichende Credits: Das Credit-Limit des Arbeitsbereichs wurde erreicht.
  • Name
    404 - Not Found
    Description

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

  • Name
    429 - Too Many Requests
    Description

    Sie haben Ihr Kontingent für ausstehende Aufgaben oder die Ratenbegrenzung überschritten.

Anfrage

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

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

Antwort

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}
GET/openapi/v1/print/repair/:id

Abrufen einer Druckbarkeit reparieren Aufgabe

Dieser Endpunkt ruft eine Druckbarkeit reparieren Aufgabe anhand ihrer ID ab.

Parameter

  • Name
    id
    Type
    path
    Description

    Die ID der Druckbarkeit reparieren Aufgabe, die abgerufen werden soll.

Rückgaben

Das Druckbarkeit reparieren Aufgabenobjekt. Der model_urls Block ist leer, bis die Aufgabe den Status SUCCEEDED erreicht. Nur das model_urls Feld, das dem Eingabeformat entspricht, wird ausgefüllt.

Anfrage

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

Antwort

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}
DELETE/openapi/v1/print/repair/:id

Eine Druckbarkeit reparieren Aufgabe löschen

Dieser Endpunkt löscht dauerhaft eine Druckbarkeit reparieren Aufgabe und deren repariertes Ergebnis. Diese Aktion ist unwiderruflich.

Pfadparameter

  • Name
    id
    Type
    path
    Description

    Die ID der zu löschenden Druckbarkeit reparieren Aufgabe.

Rückgaben

Gibt 200 OK bei Erfolg zurück.

Anfrage

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

Antwort

// Returns 200 Ok on success.
GET/openapi/v1/print/repair

Liste der Druckbarkeit-reparieren-Aufgaben

Dieser Endpunkt ermöglicht es Ihnen, eine Liste von Druckbarkeit-reparieren-Aufgaben abzurufen.

Parameter

Optionale Attribute

  • Name
    page_num
    Type
    integer
    Description

    Seitennummer für die Paginierung. Beginnt und standardmäßig auf 1.

  • Name
    page_size
    Type
    integer
    Description

    Begrenzung der Seitengröße. Standardmäßig 10 Elemente. Maximal erlaubt sind 50 Elemente.

  • Name
    sort_by
    Type
    string
    Description

    Feld zum Sortieren. Verfügbare Werte:

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

Rückgaben

Gibt eine paginierte Liste von Druckbarkeit-reparieren-Aufgaben-Objekten zurück.

Anfrage

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

Antwort

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-repair",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000030000,
    "expires_at": 1715725401000,
    "task_error": null,
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "gltf": "",
      "fbx": "",
      "obj": "",
      "stl": "",
      "usdz": "",
      "3mf": "",
      "mtl": ""
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]
GET/openapi/v1/print/repair/:id/stream

Streamen einer Druckbarkeit reparieren Aufgabe

Dieser Endpunkt streamt Echtzeit-Updates für eine Druckbarkeit reparieren Aufgabe unter Verwendung von Server-Sent Events (SSE).

Parameter

  • Name
    id
    Type
    path
    Description

    Eindeutiger Bezeichner für die Druckbarkeit reparieren Aufgabe, die gestreamt werden soll.

Rückgaben

Gibt einen Stream von Druckbarkeit reparieren Aufgaben Objekten als Server-Sent Events zurück.

Für PENDING oder IN_PROGRESS Aufgaben enthält der Antwortstream nur die notwendigen progress und status Felder. Der model_urls Block wird nur gesendet, wenn die Aufgabe SUCCEEDED erreicht.

Anfrage

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

Antwort Stream

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

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Das Druckbarkeit reparieren Aufgabenobjekt

  • Name
    id
    Type
    string
    Description

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

  • Name
    type
    Type
    string
    Description

    Typ der Druckbarkeit reparieren Aufgabe. Der Wert ist print-repair.

  • Name
    status
    Type
    string
    Description

    Status der Aufgabe. Mögliche Werte sind einer von PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Fortschritt der Aufgabe. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0. Sobald die Aufgabe erfolgreich abgeschlossen ist, wird dies 100.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Die Anzahl der vorhergehenden Aufgaben.

    Der Wert dieses Feldes ist nur sinnvoll, wenn der Aufgabenstatus PENDING ist.

  • Name
    created_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe erstellt wurde, in Millisekunden.

  • Name
    started_at
    Type
    timestamp
    Description

    Zeitstempel, wann die Aufgabe gestartet wurde, in Millisekunden. Wenn die Aufgabe noch nicht gestartet wurde, ist diese Eigenschaft 0.

  • Name
    finished_at
    Type
    timestamp
    Description

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

  • Name
    expires_at
    Type
    timestamp
    Description

    Zeitstempel, wann das Ergebnis der Aufgabe aus dem System gelöscht wird, in Millisekunden. 0, wenn die Aufgabe noch nicht abgeschlossen ist.

  • Name
    task_error
    Type
    object
    Description

    Fehlerinformationen, wenn die Aufgabe fehlgeschlagen ist. Diese Eigenschaft ist null, wenn die Aufgabe nicht fehlgeschlagen ist. Siehe Fehler für weitere Details.

    • Name
      message
      Type
      string
      Description

      Fehlermeldung, die beschreibt, was schiefgelaufen ist.

  • Name
    model_urls
    Type
    object
    Description

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

    • Name
      glb
      Type
      string
      Description

      Herunterladbare URL zum reparierten GLB. Wird gefüllt, wenn die Eingabe ein GLB war oder wenn input_task_id verwendet wurde.

    • Name
      gltf
      Type
      string
      Description

      Herunterladbare URL zum reparierten GLTF. Wird gefüllt, wenn die Eingabe ein GLTF-Upload war.

    • Name
      fbx
      Type
      string
      Description

      Herunterladbare URL zum reparierten FBX. Wird gefüllt, wenn die Eingabe ein FBX-Upload war.

    • Name
      obj
      Type
      string
      Description

      Herunterladbare URL zum reparierten OBJ. Wird gefüllt, wenn die Eingabe ein OBJ-Upload war.

    • Name
      stl
      Type
      string
      Description

      Herunterladbare URL zum reparierten STL. Wird gefüllt, wenn die Eingabe ein STL-Upload war.

    • Name
      usdz
      Type
      string
      Description

      Reserviert für USDZ-Ausgabe. Immer eine leere Zeichenfolge für Druckbarkeit reparieren Aufgaben.

    • Name
      3mf
      Type
      string
      Description

      Reserviert für 3MF-Ausgabe. Immer eine leere Zeichenfolge für Druckbarkeit reparieren Aufgaben.

    • Name
      mtl
      Type
      string
      Description

      Reserviert für MTL-Ausgabe. Immer eine leere Zeichenfolge für Druckbarkeit reparieren Aufgaben.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL eines Vorschaubildes, das aus dem reparierten Modell gerendert wurde.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    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.

  • Name
    texture_urls
    Type
    array
    Description

    Immer ein leeres Array. Die Reparatur bewahrt nur die Eingabegeometrie und backt keine Texturen neu.

  • Name
    consumed_credits
    Type
    integer
    Description

    Die Anzahl der von dieser Aufgabe verbrauchten Credits. 10, sobald die Aufgabe SUCCEEDED erreicht hat. Gibt 0 für FAILED Aufgaben zurück (Credits werden bei einem Fehler zurückerstattet).

Das Druckbarkeit reparieren Aufgabenobjekt

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}