Printbaarheid repareren API

De ID van een geslaagde taak die u bezit. Ondersteunde taaktypen: Afbeelding naar 3D, Multi-afbeelding naar 3D, Tekst naar 3D, Remesh, Hertextureren, en Printbaarheid analyseren. De taak moet de status SUCCEEDED hebben en een GLB-asset hebben geproduceerd.

Een analysetaak die wanddikte controleerde, geeft ook zijn printer en formaat door, zodat de reparatie de wanddikte controleert en dunne wanden verdikt, zelfs als u geen van beide verstuurt; een printer_type of printformaat dat u verstuurt overschrijft die waarde. Analysetaken die zijn aangemaakt vanuit een .stl, .fbx, of .gltf model_url worden niet geaccepteerd: stuur het bestand in plaats daarvan als model_url.

URL van een 3D-model om te repareren. Ondersteunde formaten: .glb, .gltf, .obj, .fbx, .stl. Gebruik een http of https URL, of een base64 data: URL voor een GLB (data:model/gltf-binary;base64,...) of glTF (data:model/gltf+json;base64,...). .obj, .fbx en .stl bestanden moeten worden verstuurd als een http of https URL.

Maximale bestandsgrootte: 400 MB voor een http of https URL, 100 MB voor een data: URI.

Een GLB-, glTF-, FBX- of OBJ-bestand van meer dan 100 MB mag maximaal 10.000.000 vlakken hebben. Vlakken worden geteld als driehoeken: een vierhoek telt als 2, en een mesh die meer dan eens wordt getekend telt één keer per kopie. Boven 100 MB moet een FBX-bestand binaire FBX 7.1 of nieuwer zijn, en mag een GLB- of glTF-bestand geen Draco-compressie gebruiken.

Meshy-downloadlinks (assets.meshy.ai/…?Expires=…&Signature=…) zijn ondertekend en werken niet meer na de expires_at van de taak; de taak opnieuw ophalen vernieuwt ze niet. Voor een model dat met Meshy is gegenereerd, geeft u in plaats daarvan input_task_id door. Dit werkt zolang de brontaak bewaard blijft (zie Asset-retentie). Om een model daarna opnieuw te gebruiken, download het vóór expires_at en stuur uw eigen kopie.

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

De printer die u van plan bent te gebruiken. Dit bepaalt de minimale wanddikte waarnaar de reparatie streeft. Standaard fdm wanneer u een printformaat stuurt zonder dit op te geven, tenzij een analysetaak die als input_task_id is doorgegeven de printer aanlevert.

Beschikbare waarden:

• fdm: filament, 1,0 mm minimale wanddikte.
• sla: hars, 0,8 mm minimale wanddikte.
• full_color: volledige kleur, 2,0 mm minimale wanddikte.

Hoogte van de print, in millimeters. Bereik: [1, 1000]. Afgerond naar de dichtstbijzijnde millimeter. Alleen GLB-invoer.

Lengte van de langste zijde van de print, in millimeters. Bereik: [1, 1000]. Afgerond naar de dichtstbijzijnde millimeter. Werkt met elk invoerformaat.

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ontbrekende parameter: noch input_task_id noch model_url is opgegeven.
• Ongeldige UUID: input_task_id is geen geldige UUID.
• Ongeldige model-URL: model_url is misvormd, gebruikt een niet-ondersteund schema, of heeft een niet-ondersteunde bestandsextensie.
• Modelbestand te groot: de inhoud van model_url overschreed 400 MB (http of https URL) of 100 MB (data: URI).
• Te veel vlakken: model_url is een GLB-, glTF-, FBX- of OBJ-bestand van meer dan 100 MB met meer dan 10.000.000 vlakken. Verminder het aantal vlakken en stuur het bestand opnieuw.
• ASCII FBX groter dan 100 MB: model_url is een ASCII FBX groter dan 100 MB. Stuur het als binaire FBX of GLB.
• Onleesbaar modelbestand: model_url is groter dan 100 MB en de header kan niet worden gelezen, bijvoorbeeld een Draco-gecomprimeerde GLB of glTF, of een binaire FBX ouder dan 7.1.
• Modelheader te complex: model_url is groter dan 100 MB en de header heeft te veel meshes, nodes of records om te controleren. Verminder het aantal objecten in het bestand en stuur het opnieuw.
• Modelbestand kon niet worden gedownload: model_url gaf een fout terug, meestal doordat een ondertekende Meshy-downloadlink is verlopen. De taak opnieuw ophalen geeft dezelfde URL met dezelfde vervaldatum terug, dus stuur uw eigen kopie van het bestand, of gebruik input_task_id zolang de brontaak nog bewaard blijft.
• Taak niet geslaagd: de referentietaak is nog in behandeling, in uitvoering, of mislukt.
• GLB ontbreekt: de referentietaak heeft geen GLB-asset om te repareren.
• Ongeldig printformaat: intended_print_height_mm of intended_print_longest_side_mm valt buiten [1, 1000], of beide zijn verstuurd.
• Onbekend printertype: printer_type is niet fdm, sla, of full_color.
• Hoogte op een niet-GLB-model: intended_print_height_mm is verstuurd met een model_url die niet .glb is. Gebruik in plaats daarvan intended_print_longest_side_mm.
• Kan dit model niet schalen op hoogte: bij de aangevraagde hoogte (of de standaard 150 mm) zou de langste zijde van het model buiten [1, 1000] mm vallen, is het model plat, of kan de grootte niet worden bepaald. Gebruik in plaats daarvan intended_print_longest_side_mm. Voor een .glb model_url en sommige input_task_id taken wordt dit pas gevonden nadat de taak is gestart, en eindigt de taak in plaats daarvan als FAILED.
• STL-formaat onbruikbaar: printer_type is verstuurd zonder formaat, en de eigen langste zijde van de .stl kan niet worden gelezen of valt buiten [1, 1000] mm. Stuur intended_print_longest_side_mm.

Authenticatie mislukt. Controleer uw API-sleutel.

Veelvoorkomende oorzaken:

• Gratis abonnement: het aanmaken van taken vereist een betaald abonnement. Upgrade op de abonnementspagina.
• Onvoldoende credits: de credit-limiet van de werkruimte is bereikt.

De referentietaak bestaat niet of is eigendom van een andere gebruiker.

U heeft uw quotum voor openstaande taken of uw rate limit overschreden.

De ID van de repair-printability-taak die moet worden opgehaald.

De ID van de printbaarheid-reparatietaak die moet worden verwijderd.

Paginanummer voor paginering. Begint bij en standaard is 1.

Limiet voor paginagrootte. Standaard 10 items. Maximaal toegestaan is 100 items.

Veld om op te sorteren. Beschikbare waarden:

• +created_at: Sorteer op aanmaaktijd in oplopende volgorde.
• -created_at: Sorteer op aanmaaktijd in aflopende volgorde.

Unieke identifier voor de printbaarheid-repareren-taak die gestreamd moet worden.

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

Type van de repair-printability-taak. De waarde is print-repair.

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

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

Het aantal voorgaande taken.

Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

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

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

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

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

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

URL van een voorbeeldafbeelding gerenderd vanuit het gerepareerde model.

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

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

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

De printer en afmeting die de reparatie gebruikte, ongeacht of deze werd meegestuurd of hergebruikt uit een analyze-taak. Aanwezig bij een wanddikte-reparatie vanaf het begin (PENDING); waarden die nog niet bekend zijn, zijn null.

Wat de wanddikte-reparatie heeft gedaan. Aanwezig zodra een wanddikte-reparatie is geslaagd.