Printbaarheid repareren API

Repareer een 3D-model voor FDM printbaarheid — herstel niet-manifold randen, gedegenereerde vlakken, gaten en andere topology problemen zodat de mesh printklaar is.

POST/openapi/v1/print/repair

Maak een Printbaarheid Repareren Taak

Deze endpoint creëert een nieuwe printbaarheid-repareren taak. De taak voert topology-reparatie uit op een 3D-model en levert een waterdichte, printklare versie op.

Het uitvoerformaat komt overeen met het invoerformaat. Als je een .stl indient via model_url, zal de model_urls.stl van de respons de gerepareerde mesh bevatten en zullen de andere formaatvelden leeg zijn. Het input_task_id pad leest altijd de GLB van de bronopdracht, dus de uitvoer is .glb.

Parameters

Slechts één van input_task_id of model_url is vereist. Als beide worden verstrekt, heeft input_task_id prioriteit.

Bestaande textures worden verwijderd tijdens de reparatie vanwege veranderingen in de geometrie. Om textures terug toe te voegen, gebruik de Retexture API op het gerepareerde model.

  • Name
    model_url
    Type
    string
    Verplicht
    Description

    URL van een 3D-model om te repareren. Ondersteunde formaten: .glb, .gltf, .obj, .fbx, .stl. Maximale bestandsgrootte: 100 MB. Moet http, https, of een data: URL gebruiken (data-URL's omzeilen extensiecontroles).

  • Name
    alpha_thumbnail
    Type
    boolean
    standaard false
    Description

    Wanneer ingesteld op true, rendert de taak bovendien een versie van de preview met transparante achtergrond (RGBA) en retourneert deze als alpha_thumbnail_url in de GET-respons. Het bestaande thumbnail_url veld blijft ongewijzigd.

Retourneert

De result eigenschap van de respons bevat de id van de nieuw aangemaakte printbaarheid-repareren taak.

Foutmodi

  • Name
    400 - Bad Request
    Description

    Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

    • Ontbrekende parameter: noch input_task_id noch model_url was verstrekt.
    • Ongeldige UUID: input_task_id is geen geldige UUID.
    • Ongeldige model-URL: model_url is verkeerd gevormd, gebruikt een niet-ondersteund schema, of heeft een niet-ondersteunde bestandsextensie.
    • Modelbestand te groot: model_url body overschreed 100 MB.
    • Taak niet geslaagd: de verwezen taak is nog in behandeling, in uitvoering, of mislukt.
    • Ontbrekende GLB: de verwezen taak heeft geen GLB asset om te repareren.
  • Name
    401 - Unauthorized
    Description

    Authenticatie mislukt. Controleer je API-sleutel.

  • Name
    402 - Payment Required
    Description

    Veelvoorkomende oorzaken:

    • Gratis plan: het aanmaken van taken vereist een betaald plan. Upgrade op de abonnement pagina.
    • Onvoldoende credits: de werkruimte creditlimiet is bereikt.
  • Name
    404 - Not Found
    Description

    De verwezen taak bestaat niet of is eigendom van een andere gebruiker.

  • Name
    429 - Too Many Requests
    Description

    Je hebt je limiet voor in behandeling zijnde taken of rate limit overschreden.

Request

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"
  }'

Response

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

Haal een Printbaarheid Repareren Taak op

Deze endpoint haalt een printbaarheid-repareren taak op via zijn ID.

Parameters

  • Name
    id
    Type
    path
    Description

    De ID van de printbaarheid-repareren taak die moet worden opgehaald.

Retourneert

Het Printbaarheid Repareren Taak Object. Het model_urls blok is leeg totdat de taak SUCCEEDED bereikt. Alleen het model_urls veld dat overeenkomt met het invoerformaat wordt gevuld.

Request

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}"

Response

{
  "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

Een Printbaarheid Repareren Taak Verwijderen

Deze endpoint verwijdert permanent een printbaarheid repareren taak en de gerepareerde output. Deze actie is onomkeerbaar.

Padparameters

  • Name
    id
    Type
    path
    Description

    De ID van de printbaarheid repareren taak die moet worden verwijderd.

Retourneert

Retourneert 200 OK bij succes.

Request

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}"

Response

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

Lijst Printbaarheid Repareren Taken

Deze endpoint stelt je in staat om een lijst van printbaarheid-reparatietaken op te halen.

Parameters

Optionele attributen

  • Name
    page_num
    Type
    integer
    Description

    Paginanummer voor paginering. Begint en standaard op 1.

  • Name
    page_size
    Type
    integer
    Description

    Limiet voor paginagrootte. Standaard is 10 items. Maximum toegestaan is 50 items.

  • Name
    sort_by
    Type
    string
    Description

    Veld om op te sorteren. Beschikbare waarden:

    • +created_at: Sorteren op creatietijd in oplopende volgorde.
    • -created_at: Sorteren op creatietijd in aflopende volgorde.

Retourneert

Retourneert een gepagineerde lijst van Printbaarheid Repareren Taakobjecten.

Request

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

Response

[
  {
    "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

Stream een Printbaarheid repareren Taak

Deze endpoint streamt real-time updates voor een printbaarheid repareren taak met behulp van Server-Sent Events (SSE).

Parameters

  • Name
    id
    Type
    path
    Description

    Unieke identificatie voor de printbaarheid repareren taak om te streamen.

Retourneert

Retourneert een stream van Printbaarheid repareren Taak Objecten als Server-Sent Events.

Voor PENDING of IN_PROGRESS taken, zal de responsstream alleen de noodzakelijke progress en status velden bevatten. Het model_urls blok wordt alleen verzonden zodra de taak SUCCEEDED bereikt.

Request

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}"

Response 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
}

Het Printbaarheid Repareren Taakobject

  • Name
    id
    Type
    string
    Description

    Unieke identificatie voor de taak. Hoewel we een k-sortable UUID gebruiken voor taak-id's als implementatiedetail, moet je geen aannames maken over het formaat van de id.

  • Name
    type
    Type
    string
    Description

    Type van de printbaarheid repareren taak. De waarde is print-repair.

  • Name
    status
    Type
    string
    Description

    Status van de taak. Mogelijke waarden zijn een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Voortgang van de taak. Als de taak nog niet is gestart, zal deze eigenschap 0 zijn. Zodra de taak is geslaagd, wordt dit 100.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Het aantal voorgaande taken.

    De waarde van dit veld is alleen betekenisvol als de taakstatus PENDING is.

  • Name
    created_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

  • Name
    started_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer de taak is gestart, in milliseconden. Als de taak nog niet is gestart, zal deze eigenschap 0 zijn.

  • Name
    finished_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, zal deze eigenschap 0 zijn.

  • Name
    expires_at
    Type
    timestamp
    Description

    Tijdstempel van wanneer het taakresultaat uit het systeem zal verlopen, in milliseconden. 0 als de taak nog niet is voltooid.

  • Name
    task_error
    Type
    object
    Description

    Foutinformatie als de taak is mislukt. Deze eigenschap is null als de taak niet is mislukt. Zie Fouten voor meer details.

    • Name
      message
      Type
      string
      Description

      Foutmelding die beschrijft wat er misging.

  • Name
    model_urls
    Type
    object
    Description

    Downloadbare URL's naar het gerepareerde 3D-model. Alleen het veld dat overeenkomt met het invoerformaat is gevuld; de andere formaatvelden zijn lege strings.

    • Name
      glb
      Type
      string
      Description

      Downloadbare URL naar de gerepareerde GLB. Gevuld wanneer de invoer een GLB was of wanneer input_task_id werd gebruikt.

    • Name
      gltf
      Type
      string
      Description

      Downloadbare URL naar de gerepareerde GLTF. Gevuld wanneer de invoer een GLTF-upload was.

    • Name
      fbx
      Type
      string
      Description

      Downloadbare URL naar de gerepareerde FBX. Gevuld wanneer de invoer een FBX-upload was.

    • Name
      obj
      Type
      string
      Description

      Downloadbare URL naar de gerepareerde OBJ. Gevuld wanneer de invoer een OBJ-upload was.

    • Name
      stl
      Type
      string
      Description

      Downloadbare URL naar de gerepareerde STL. Gevuld wanneer de invoer een STL-upload was.

    • Name
      usdz
      Type
      string
      Description

      Gereserveerd voor USDZ-uitvoer. Altijd een lege string voor printbaarheid repareren taken.

    • Name
      3mf
      Type
      string
      Description

      Gereserveerd voor 3MF-uitvoer. Altijd een lege string voor printbaarheid repareren taken.

    • Name
      mtl
      Type
      string
      Description

      Gereserveerd voor MTL-uitvoer. Altijd een lege string voor printbaarheid repareren taken.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL van een voorbeeldafbeelding gerenderd van het gerepareerde model.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    Downloadbare URL naar een versie van thumbnail_url met transparante achtergrond (RGBA). Alleen aanwezig wanneer de taak is aangemaakt met alpha_thumbnail: true en de transparante preview succesvol is gerenderd; anders wordt dit veld weggelaten.

  • Name
    texture_urls
    Type
    array
    Description

    Altijd een lege array. Reparatie behoudt alleen de invoergeometrie en bakt geen textures opnieuw.

  • Name
    consumed_credits
    Type
    integer
    Description

    Het aantal credits dat door deze taak is verbruikt. 10 zodra de taak SUCCEEDED heeft bereikt. Geeft 0 terug voor FAILED taken (credits worden terugbetaald bij mislukking).

Het Printbaarheid Repareren Taakobject

{
  "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
}