Reliéf API

Fotografie, která se má proměnit v reliéf, jako veřejně dostupná URL adresa nebo Data URI (data:image/png;base64,...).

Obrázek musí být soubor JPG, JPEG, PNG nebo WebP o velikosti nejvýše 20 MB a rozměrech alespoň 32 × 32 pixelů. Jeho delší strana může být nejvýše přibližně 16× delší než kratší strana. Jakýkoli jiný obrázek vrátí 400. Meshy před vytvořením reliéfu vyplní průhledné oblasti černou barvou.

Styl reliéfu. Určuje tvar hloubkové mapy a výchozí hodnotu carving_depth_mm.

Dostupné hodnoty:

• high: hlubší rytí, pro 3D tištěné kusy.
• low: mělké rytí, pro laserové gravírování, CNC rytí a tenké destičky.

Odeslání null nebo "" má stejný účinek jako vynechání parametru. Jakákoli jiná hodnota vrátí 400.

Zda se má vytvořit reliéfní model. Nastavte na false pro úlohu, která vytvoří pouze hloubkovou mapu, bez modelu a bez náhledového obrázku. Meshy přesto zkontroluje parametry velikosti, rytí, základny, ohybu a rozlišení, ale nepoužije je. Toto nastavení nemění cenu v kreditech.

Délka delší strany fotografie na modelu, měřená v plochém stavu před jakýmkoli ohybem, od 20 do 250 milimetrů. S parametrem remove_base může být model menší.

Zda motiv vystupuje z desky, nebo je do ní vyryt.

Dostupné hodnoty:

• emboss: bližší části fotografie vystupují.
• engrave: hloubka je obrácená, takže bližší části jsou vyryty dovnitř.

Hloubková mapa je v obou režimech stejná.

Jak hluboko je reliéf vyryt, od 0 do 60 milimetrů. Pokud je remove_base nastaveno na true, hodnota 0 vytvoří prázdný model. Úloha přesto proběhne úspěšně a stojí 20 kreditů, přičemž její soubory GLB a STL neobsahují žádnou geometrii.

Zda se má odříznout pozadí a nevytvářet základní desku. Pokud je true, removal_threshold určuje, co se považuje za pozadí. Meshy kontroluje removal_threshold v obou případech.

Tloušťka základní desky, od 0.1 do 10 milimetrů. Pokud je remove_base nastaveno na true, vynechte tento parametr nebo odešlete 0.

Zda a jakým směrem se má reliéf ohnout. Pokud není off, tvar ohybu určují bend_axis a bend_angle. Meshy je kontroluje v obou případech.

Dostupné hodnoty:

• off: plochý reliéf.
• convex: přední strana se vyklenuje ven.
• concave: přední strana se prohýbá dovnitř.

Počet bodů sítě podél delší strany fotografie, od 512 do 2048. Vyšší hodnota zachovává jemnější detaily a vytváří větší soubory. Při výchozí hodnotě 1024 má soubor GLB přibližně 40 až 50 MB a soubor STL přibližně 80 až 105 MB. Čtvercová fotografie dává větší velikosti. Při hodnotě 2048 jsou to přibližně 150 MB a 300 MB. Ohyb je ještě zvětšuje: soubor STL může při hodnotě 2048 dosáhnout přibližně 800 MB.

Požadavek nelze spustit. Chybová zpráva uvádí, jaký problém byl zjištěn. Například:

• Chybějící parametr: nebyl odeslán image_url.
• Neplatný parametr: Parametr má špatný typ, je mimo svůj rozsah, nebo není jednou z dostupných hodnot. Například variant není high ani low, nebo mesh_resolution není celé číslo od 512 do 2048.
• Tloušťka základny: base_thickness_mm není 0, pokud je remove_base nastaveno na true, nebo je nižší než 0.1, pokud nastaveno není.
• Nedostupná URL adresa: Meshy nemůže stáhnout obrázek z image_url, například protože URL adresa vrací 404 nebo vyprší časový limit.
• Neplatný obrázek: Obrázek není soubor JPG, JPEG, PNG ani WebP, má více než 20 MB, je menší než 32 × 32 pixelů, má příliš mnoho pixelů nebo jej nelze přečíst.
• Extrémní poměr stran: Delší strana obrázku je více než přibližně 16× delší než kratší strana.

Opravte požadavek a odešlete jej znovu. Meshy jej neúčtuje. Viz Chyby.

API klíč chybí nebo je neplatný. Zkontrolujte hlavičku Authorization.

Například:

• Nedostatek kreditů: Účet nemá dostatek kreditů pro tuto úlohu, nebo účet dosáhl limitu kreditů. Zkontrolujte svůj zůstatek kreditů a zkuste to znovu.
• Plán zdarma: Vytvoření úlohy vyžaduje placený plán. Upgradujte svůj plán v nastavení předplatného a zkuste to znovu.

Moderation obsahu obrázek zablokovala. Meshy požadavek neúčtuje. Odešlete jiný obrázek.

Byl dosažen jeden z těchto limitů:

• Odeslali jste příliš mnoho požadavků. Počkejte a poté to zkuste znovu. Viz Omezení rychlosti.
• Příliš mnoho vašich úloh čeká ve frontě nebo běží. Počkejte, až se některé dokončí, a poté to zkuste znovu.
• V neomezeném plánu bez zbývajících kreditů jste dosáhli počtu úloh, které mohou běžet bez kreditů. Počkejte, až se nějaká úloha dokončí, nebo přidejte kredity.

ID úlohy z odpovědi na vytvoření.

ID úlohy, která má být smazána.

Číslo stránky, kterou chcete vrátit. Začíná na 1 a výchozí hodnota je 1.

Počet úloh na stránku, až 100. Výchozí hodnota je 10. Meshy zachází s hodnotou od 101 do 255 jako s 100 a vyšší hodnota vrátí 400.

Pořadí řazení.

Dostupné hodnoty:

• +created_at: od nejstarších
• -created_at: od nejnovějších

ID úlohy z odpovědi na vytvoření.

ID úkolu. Považujte jej za neprůhledný řetězec a nespoléhejte na jeho formát.

Typ úkolu, vždy relief.

Adresy URL ke stažení modelu reliéfu. Soubory mohou být velké; mesh_resolution uvádí typické velikosti.

Adresa URL ke stažení 16bitové mapy hloubky ve stupních šedi, ze které je reliéf vytvořen. Světlejší pixely jsou výše. Hodnoty představují relativní výšky, nikoli milimetry. Software pro laserové gravírování a CNC ji může použít jako výškovou mapu. Soubor má přibližně 1 až 2 MB. Prázdné, pokud žádná neexistuje.

Adresa URL ke stažení náhledového obrázku modelu reliéfu. Prázdné, pokud nebyl žádný vykreslen, včetně úkolu generujícího pouze mapu hloubky.

Kolik z úkolu je hotovo, v procentech. Je 0, dokud úkol nezačne, a 100, když uspěje.

Stav úkolu, jeden z PENDING, IN_PROGRESS, SUCCEEDED nebo FAILED.

Počet úkolů před tímto úkolem ve frontě. Pole se vynechává, pokud je hodnota 0, takže se zobrazuje pouze tehdy, když jsou před tímto úkolem jiné úkoly.

Čas vytvoření úkolu, v milisekundách Unixového času.

Čas spuštění úkolu, v milisekundách Unixového času. Je 0, dokud úkol nezačne.

Čas dokončení úkolu, v milisekundách Unixového času. Je 0, dokud úkol neskončí.

Čas vypršení platnosti výsledku úkolu, v milisekundách Unixového času. Je 0, dokud úkol neskončí.

Podrobnosti o chybě, pokud úkol selže. Viz Chyby.

Počet kreditů, které úkol spotřeboval: 20, nebo 0 u úkolu se stavem FAILED, který Meshy vrátí.