Printbaarheid analyseren API

Vereist, tenzij je model_url meestuurt. De ID van de taak waarvan je het model wilt analyseren. De taak moet de status SUCCEEDED hebben en van jou zijn of zich in een werkruimte bevinden waartoe jij behoort.

Het kan een van deze taaktypen zijn, met Meshy 6 of nieuwer, inclusief Meshy 7:

• Afbeelding naar 3D
• Multi-afbeelding naar 3D
• Tekst naar 3D
• Remesh
• Hertextureren

Een Printbaarheid repareren-taak werkt ook.

Vereist, tenzij je input_task_id meestuurt. Het te analyseren model, als een openbare URL of een data-URI. Als je beide meestuurt, gebruikt Meshy input_task_id.

Vanaf een http- of https-URL moet het model een .glb-, .gltf-, .obj-, .fbx- of .stl-bestand van maximaal 400 MB zijn. Een data-URI kan alleen een base64 GLB- (data:model/gltf-binary;base64,...) of glTF-bestand (data:model/gltf+json;base64,...) van maximaal 100 MB bevatten. Stuur een .obj-, .fbx- of .stl-bestand als een http- of https-URL.

Een bestand groter dan 100 MB moet ook aan deze regels voldoen:

• Een GLB-, glTF-, FBX- of OBJ-bestand mag maximaal 10.000.000 vlakken hebben. Meshy telt vlakken als driehoeken, dus een vierhoek telt als 2, en een mesh die meerdere keren is getekend telt eenmaal per kopie.
• Een FBX-bestand moet binaire FBX 7.1 of nieuwer zijn.
• Een GLB- of glTF-bestand mag geen Draco-compressie gebruiken.

Een Meshy-downloadlink (assets.meshy.ai/…?Expires=…&Signature=…) is ondertekend en werkt niet meer na de expires_at van de bijbehorende taak. De taak opnieuw opvragen vernieuwt deze niet. Stuur voor een model dat je met Meshy hebt gemaakt in plaats daarvan input_task_id, wat werkt zolang Meshy de brontaak bewaart (zie Asset-retentie). Om het model daarna te gebruiken, download je het vóór expires_at en stuur je je eigen kopie mee.

De printer die je van plan bent te gebruiken. Dit bepaalt de minimale wanddikte voor de wanddiktecontrole. Als je een printformaat meestuurt zonder printer_type, gebruikt Meshy fdm.

Beschikbare waarden:

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

Elke andere waarde geeft 400 terug.

De hoogte van de print, in millimeters, van 1 tot 1000. Een waarde buiten dit bereik geeft 400 terug. Stuur dit of intended_print_longest_side_mm, niet beide.

Het werkt alleen met GLB-invoer. Voor een model_url die geen .glb-bestand is, stuur je in plaats daarvan intended_print_longest_side_mm.

De lengte van de langste zijde van de print, in millimeters, van 1 tot 1000. Een waarde buiten dit bereik geeft 400 terug. Het werkt met elk invoerformaat.

Het verzoek kan niet worden uitgevoerd. Het foutbericht vermeldt welk probleem is gevonden. Bijvoorbeeld:

• Ontbrekende parameter: Noch input_task_id noch model_url is meegestuurd.
• Ongeldige UUID: input_task_id is geen geldige UUID.
• Ongeldige model-URL: model_url is onjuist opgemaakt, gebruikt een niet-ondersteund schema, of heeft een niet-ondersteunde bestandsextensie.
• Modelbestand te groot: Het model_url-bestand is groter dan 400 MB vanaf een http- of https-URL, of groter dan 100 MB als data-URI.
• Te veel vlakken: Het model_url-bestand is een GLB-, glTF-, FBX- of OBJ-bestand groter 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: Het model_url-bestand is een ASCII FBX groter dan 100 MB. Stuur het als binaire FBX of GLB.
• Onleesbaar modelbestand: Het model_url-bestand is groter dan 100 MB en Meshy kan de header niet lezen. Het is bijvoorbeeld een Draco-gecomprimeerde GLB of glTF, of een binaire FBX ouder dan 7.1.
• Modelheader te complex: Het model_url-bestand 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 kan niet worden gedownload: model_url gaf een fout terug, meestal omdat een ondertekende Meshy-downloadlink is verlopen. De taak opnieuw opvragen geeft dezelfde URL terug met dezelfde vervaldatum. Stuur je eigen kopie van het bestand, of stuur input_task_id zolang Meshy de brontaak bewaart.
• Taak niet geslaagd: De input_task_id-taak is nog in behandeling, bezig, of mislukt.
• Ongeldig printformaat: intended_print_height_mm of intended_print_longest_side_mm valt buiten 1 tot 1000, of het verzoek bevat beide.
• Onbekend printertype: printer_type is niet fdm, sla of full_color.
• Hoogte op een niet-GLB-model: Het verzoek bevat intended_print_height_mm en een model_url die geen .glb-bestand is. Stuur in plaats daarvan intended_print_longest_side_mm.
• Kan dit model niet schalen op hoogte: Bij de gevraagde hoogte, of de standaard 150 mm, zou de langste zijde van het model buiten 1 tot 1.000 mm vallen. Dit gebeurt ook wanneer het model plat is, of wanneer Meshy de grootte niet kan bepalen. Stuur in plaats daarvan intended_print_longest_side_mm. Voor een .glb-model_url en sommige input_task_id-taken ontdekt Meshy dit pas nadat de taak is gestart, en eindigt de taak in plaats daarvan als FAILED.
• STL-formaat onbruikbaar: Het verzoek bevat printer_type zonder formaat, en Meshy kan de eigen langste zijde van het .stl-bestand niet lezen, of deze valt buiten 1 tot 1.000 mm. Stuur intended_print_longest_side_mm.

Herstel het verzoek en stuur het opnieuw. Zie Fouten.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

input_task_id is een bas-reliëfmodel, dat dit endpoint niet kan analyseren. Het bericht is This model type does not support this operation. Stuur een ander model.

Meshy kan geen model vinden om te analyseren voor input_task_id. Bijvoorbeeld:

• De taak bestaat niet, is verwijderd, of is niet van jou of bevindt zich niet in een werkruimte waartoe jij behoort.
• De taak gebruikt een model ouder dan Meshy 6, of het type ervan produceert geen 3D-model.
• Het modelbestand van de taak staat niet meer in de opslag.

Controleer of input_task_id een ondersteunde taak is die van jou is of zich in een van je werkruimtes bevindt, of stuur het model als model_url.

Je hebt je rate limit overschreden, of je hebt te veel taken in behandeling. Wacht en probeer het opnieuw. Zie Rate limits.

De taak-ID uit het aanmaakantwoord.

De ID van de te verwijderen taak.

Het paginanummer dat moet worden geretourneerd, beginnend bij 1.

Het aantal taken per pagina, tot 100.

De sorteervolgorde.

Beschikbare waarden:

• +created_at: oudste eerst
• -created_at: nieuwste eerst

De task ID uit het antwoord van het aanmaken.

De taak-ID. Behandel dit als een ondoorzichtige string en vertrouw niet op het formaat ervan.

Het taaktype, altijd print-analyze.

De taakstatus, een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED of CANCELED.

Hoeveel van de taak is voltooid, als percentage. Het is 0 totdat de taak begint en 100 wanneer deze slaagt.

Het aantal taken dat vóór deze in de wachtrij staat. De waarde is alleen relevant zolang de taak PENDING is.

Tijdstip waarop de taak is aangemaakt, in Unix-milliseconden.

Tijdstip waarop de taak is gestart, in Unix-milliseconden. Het is 0 totdat de taak start.

Tijdstip waarop de taak is beëindigd, in Unix-milliseconden. Het is 0 totdat de taak eindigt.

Tijdstip waarop het resultaat van de taak verloopt, in Unix-milliseconden. Het is 0 totdat de taak eindigt.

De foutdetails wanneer de taak mislukt. Dit is null als de taak niet is mislukt. Zie Fouten.

Het resultaat van de analyse. Dit is niet aanwezig totdat de taak SUCCEEDED is.

Het aantal credits dat de taak heeft gebruikt. Dit is altijd 0, omdat analyse gratis is.