Reliëf API

De foto die wordt omgezet in een reliëf, als een openbare URL of een data-URI (data:image/png;base64,...).

De afbeelding moet een JPG-, JPEG-, PNG- of WebP-bestand zijn van maximaal 20 MB, en minstens 32 × 32 pixels. De langere zijde mag maximaal ongeveer 16 keer de kortere zijde zijn. Elke andere afbeelding geeft 400 terug. Meshy vult transparante gebieden met zwart voordat het reliëf wordt opgebouwd.

De reliëfstijl. Deze bepaalt de dieptekaart en stelt de standaard carving_depth_mm in.

Beschikbare waarden:

• high: diepere uitsnijding, voor 3D-geprinte stukken.
• low: ondiepe uitsnijding, voor lasergraveren, CNC-graveren en dunne plaquettes.

Het sturen van null of "" is hetzelfde als het weglaten. Elke andere waarde geeft 400 terug.

Of het reliëfmodel wordt gebouwd. Stel dit in op false voor een taak die alleen een dieptekaart oplevert, zonder model en zonder voorbeeldafbeelding. Meshy controleert nog steeds de parameters voor grootte, uitsnijding, basis, buiging en resolutie, maar gebruikt ze niet. Het verandert de credit-kosten niet.

De lengte van de langere zijde van de foto op het model, gemeten plat voor elke buiging, van 20 tot 250 millimeter. Met remove_base kan het model kleiner zijn.

Of het onderwerp uit de plaat steekt of erin wordt uitgesneden.

Beschikbare waarden:

• emboss: de dichterbij gelegen delen van de foto steken naar voren.
• engrave: de diepte wordt omgekeerd, zodat de dichterbij gelegen delen worden ingesneden.

De dieptekaart is in beide modi hetzelfde.

Hoe diep het reliëf wordt uitgesneden, van 0 tot 60 millimeter. Met remove_base ingesteld op true, laat 0 een leeg model achter. De taak slaagt nog steeds en kost 20 credits, en de GLB- en STL-bestanden bevatten geen geometrie.

Of de achtergrond wordt weggesneden en er geen basisplaat wordt gebouwd. Als dit true is, bepaalt removal_threshold wat als achtergrond geldt. Meshy controleert removal_threshold in beide gevallen.

De dikte van de basisplaat, van 0.1 tot 10 millimeter. Als remove_base true is, laat je dit weg of stuur je 0.

Of het reliëf wordt gebogen, en in welke richting. Als dit niet off is, bepalen bend_axis en bend_angle de vorm van de buiging. Meshy controleert ze in beide gevallen.

Beschikbare waarden:

• off: een plat reliëf.
• convex: de voorkant bolt naar buiten.
• concave: de voorkant kromt naar binnen.

Het aantal meshpunten langs de langere zijde van de foto, van 512 tot 2048. Een hogere waarde behoudt fijnere details en maakt grotere bestanden. Bij de standaardwaarde 1024 is het GLB-bestand ongeveer 40 tot 50 MB en het STL-bestand ongeveer 80 tot 105 MB. Een vierkante foto geeft de grotere bestandsgroottes. Bij 2048 zijn ze ongeveer 150 MB en 300 MB. Een buiging maakt ze groter: het STL-bestand kan bij 2048 oplopen tot ongeveer 800 MB.

Het verzoek kan niet worden uitgevoerd. Het foutbericht geeft aan welk probleem er is gevonden. Bijvoorbeeld:

• Ontbrekende parameter: image_url werd niet meegestuurd.
• Ongeldige parameter: Een parameter heeft het verkeerde type, valt buiten het bereik, of is niet een van de beschikbare waarden. Bijvoorbeeld, variant is niet high of low, of mesh_resolution is geen geheel getal van 512 tot 2048.
• Basisdikte: base_thickness_mm is niet 0 terwijl remove_base op true staat, of is lager dan 0.1 zonder dat.
• Onbereikbare URL: Meshy kan de image_url-afbeelding niet downloaden, bijvoorbeeld omdat de URL 404 teruggeeft of een time-out optreedt.
• Ongeldige afbeelding: De afbeelding is geen JPG-, JPEG-, PNG- of WebP-bestand, is groter dan 20 MB, is kleiner dan 32 × 32 pixels, heeft te veel pixels, of kan niet worden gelezen.
• Extreme beeldverhouding: De langere zijde van de afbeelding is meer dan ongeveer 16 keer de kortere zijde.

Herstel het verzoek en stuur het opnieuw. Meshy brengt hiervoor geen kosten in rekening. 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 credit-limiet bereikt. Controleer je credit-saldo en probeer het opnieuw.
• Gratis abonnement: Het aanmaken van een taak vereist een betaald abonnement. Upgrade je abonnement in je abonnementsinstellingen en probeer het opnieuw.

Contentmoderatie heeft de afbeelding geblokkeerd. Meshy brengt hiervoor geen kosten in rekening. Stuur een andere afbeelding.

Een van deze limieten is bereikt:

• Je hebt te veel verzoeken verstuurd. Wacht en probeer het opnieuw. Zie Snelheidslimieten.
• Er staan te veel van je taken in de wachtrij of lopen er al te veel. Wacht tot sommige klaar zijn en probeer het opnieuw.
• Bij een onbeperkt abonnement zonder resterende credits heb je het aantal taken bereikt dat zonder credits kan draaien. Wacht tot een taak klaar is, of voeg credits toe.

De taak-ID uit het antwoord van het aanmaken.

De ID van de te verwijderen taak.

Het paginanummer dat moet worden geretourneerd. Begint bij en standaard 1.

Het aantal taken per pagina, tot 100. Standaard 10. Meshy behandelt een waarde van 101 tot 255 als 100, en een grotere waarde geeft 400 terug.

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 relief.

Downloadlinks voor het reliëfmodel. De bestanden kunnen groot zijn; mesh_resolution geeft de gebruikelijke bestandsgroottes aan.

Downloadlink voor de 16-bit grijswaarden-dieptekaart waarop het reliëf is gebaseerd. Lichtere pixels zijn hoger. De waarden zijn relatieve hoogtes, geen millimeters. Lasergraveer- en CNC-software kan dit gebruiken als hoogtekaart. Het bestand is ongeveer 1 tot 2 MB groot. Leeg als er geen is.

Downloadlink voor een voorbeeldafbeelding van het reliëfmodel. Leeg als er geen is gerenderd, ook bij een taak die alleen een dieptekaart genereert.

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

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

Het aantal taken dat voor deze taak in de wachtrij staat. Dit veld wordt weggelaten wanneer de waarde 0 is, en verschijnt dus alleen zolang er taken voor deze taak staan.

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 is voltooid.

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

De foutgegevens wanneer de taak mislukt. Zie Fouten.

Het aantal credits dat de taak heeft gebruikt: 20, of 0 voor een FAILED-taak, wat Meshy terugbetaalt.