Printbaarheid repareren API

Vereist, tenzij u model_url verstuurt. De ID van de taak waarvan u het model wilt repareren, bijvoorbeeld een Afbeelding naar 3D-, Multi-afbeelding naar 3D-, Tekst naar 3D-, Remesh-, Hertextureren- of Printbaarheid analyseren-taak. De taak moet er een zijn die u met de API hebt aangemaakt, met status SUCCEEDED en een GLB-model.

Een Printbaarheid analyseren-taak die de wanddikte controleerde, geeft ook zijn printer en formaat door. De reparatie controleert dan de wanddikte en verdikt dunne wanden, zelfs als u geen van beide verstuurt. Een printer_type of printformaat dat u verstuurt, vervangt die van de analyse. Een Printbaarheid analyseren-taak van een .stl-, .fbx- of .gltf-bestand uit model_url werkt niet. Stuur dat bestand in plaats daarvan als model_url.

Vereist, tenzij u input_task_id verstuurt. Het te repareren model, als een openbare URL of een data-URI. Als u beide verstuurt, gebruikt Meshy input_task_id.

Vanaf een http- of https-URL moet het model een .glb-, .gltf-, .obj-, .fbx- of .stl-bestand van ten hoogste 400 MB zijn. Een data-URI kan alleen een base64 GLB (data:model/gltf-binary;base64,...) of glTF (data:model/gltf+json;base64,...) bestand van ten hoogste 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 ten hoogste 10.000.000 vlakken hebben. Meshy telt vlakken als driehoeken, dus een vierhoek telt als 2, en een mesh die meer dan eens 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 expires_at van de bijbehorende taak. De taak opnieuw opvragen vernieuwt deze niet. Stuur voor een model dat u met Meshy hebt gemaakt in plaats daarvan input_task_id, wat werkt zolang Meshy de brontaak bewaart (zie Asset-retentie). Download het model vóór expires_at en stuur uw eigen kopie om het daarna te gebruiken.

Of er ook een voorbeeld met een transparante achtergrond (RGBA) moet worden gerenderd, teruggegeven in alpha_thumbnail_url wanneer u de taak opvraagt. thumbnail_url verandert niet.

De printer die u van plan bent te gebruiken. Dit bepaalt de minimale wanddikte waarnaar de reparatie streeft. Als u een printformaat verstuurt zonder printer_type, gebruikt Meshy fdm, tenzij een Printbaarheid analyseren-taak in input_task_id de printer aanlevert.

Beschikbare waarden:

• fdm: filament, minimale wand van 1,0 mm
• sla: hars, minimale wand van 0,8 mm
• full_color: full-color, minimale wand van 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. Stuur voor een model_url die geen .glb-bestand is 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 geeft aan welk probleem er is gevonden. Bijvoorbeeld:

• Ontbrekende parameter: Noch input_task_id noch model_url werd verstuurd.
• 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: 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 met dezelfde vervaltijd terug. Stuur uw eigen kopie van het bestand, of stuur input_task_id zolang Meshy de brontaak bewaart.
• Taak niet geslaagd: De input_task_id-taak staat nog in behandeling, is in uitvoering, of is mislukt.
• Ontbrekende GLB: De input_task_id-taak heeft geen GLB-model om te repareren.
• 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 het formaat niet kan bepalen. Stuur in plaats daarvan intended_print_longest_side_mm. Voor een .glb-model_url en sommige input_task_id-taken merkt Meshy dit pas op 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.

Corrigeer het verzoek en stuur het opnieuw. Zie Fouten.

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

Bijvoorbeeld:

• Onvoldoende credits: Het account heeft niet genoeg credits voor deze taak, of het account heeft een creditlimiet bereikt. Controleer uw credit-saldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade uw abonnement in uw abonnementsinstellingen en probeer het opnieuw.

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

De input_task_id-taak bestaat niet of behoort toe aan een andere gebruiker. Controleer de ID en gebruik een API-sleutel van het account dat de taak heeft aangemaakt.

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

De taak-ID uit het antwoord van het aanmaken.

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 taak-ID uit het aanmaakantwoord.

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

Het taaktype, altijd print-repair.

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

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

Het aantal taken dat vóór deze taak 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. Dit is 0 totdat de taak start.

Tijdstip waarop de taak is voltooid, in Unix-milliseconden. Dit is 0 totdat de taak voltooid is.

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

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

Downloadlinks voor het gerepareerde model. Dit bevat alleen de sleutel die overeenkomt met het invoerformaat. Een formaat dat de taak niet heeft gegenereerd, heeft geen sleutel, in plaats van een lege string.

Downloadlink voor een voorbeeldafbeelding van het gerepareerde model.

Downloadlink voor een versie van thumbnail_url met een transparante achtergrond (RGBA). Alleen aanwezig wanneer je de taak hebt aangemaakt met alpha_thumbnail: true en Meshy de transparante preview heeft gerenderd.

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

Het aantal credits dat de taak heeft verbruikt. Dit is 10 wanneer de taak SUCCEEDED is en 0 voor een FAILED-taak, omdat Meshy de credits terugbetaalt wanneer een taak mislukt.

De printer en afmeting die de reparatie gebruikte, ongeacht of je deze hebt meegestuurd of Meshy ze heeft hergebruikt van een Analyze Printability-taak. Vanaf het begin aanwezig bij een wanddikte-reparatie, inclusief terwijl de taak PENDING is. Een waarde die Meshy nog niet kent, is null.

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