Opravit tisknutelnost API

Povinné, pokud neodešlete model_url. ID úkolu, jehož model chcete opravit, například úkolu Obrázek na 3D, Více obrázků na 3D, Text na 3D, Remesh, Retexturování nebo Analyzovat tisknutelnost. Úkol musí být vytvořen vámi pomocí API, se stavem SUCCEEDED a GLB modelem.

Úkol Analyzovat tisknutelnost, který zkontroloval tloušťku stěny, předává také svůj typ tiskárny a velikost. Oprava pak kontroluje tloušťku stěny a ztlušťuje tenké stěny, i když neodešlete ani jedno. printer_type nebo velikost tisku, kterou odešlete, nahradí tu z analýzy. Úkol Analyzovat tisknutelnost souboru .stl, .fbx nebo .gltf z model_url nefunguje. Odešlete místo toho tento soubor jako model_url.

Povinné, pokud neodešlete input_task_id. Model k opravě jako veřejná URL adresa nebo Data URI. Pokud odešlete obojí, Meshy použije input_task_id.

Z adresy URL typu http nebo https musí být model soubor .glb, .gltf, .obj, .fbx nebo .stl o velikosti nejvýše 400 MB. Data URI může obsahovat pouze base64 soubor GLB (data:model/gltf-binary;base64,...) nebo glTF (data:model/gltf+json;base64,...) o velikosti nejvýše 100 MB. Soubor .obj, .fbx nebo .stl odešlete jako adresu URL typu http nebo https.

Soubor nad 100 MB musí navíc splňovat tato pravidla:

• Soubor GLB, glTF, FBX nebo OBJ může mít nejvýše 10 000 000 ploch. Meshy počítá plochy jako trojúhelníky, takže čtyřúhelník se počítá jako 2 a síť vykreslená vícekrát se počítá jednou za každou kopii.
• Soubor FBX musí být binární FBX 7.1 nebo novější.
• Soubor GLB nebo glTF nesmí používat kompresi Draco.

URL adresa pro stažení z Meshy (assets.meshy.ai/…?Expires=…&Signature=…) je podepsaná a přestane fungovat v okamžiku expires_at příslušného úkolu. Opětovné čtení úkolu ji neobnoví. U modelu vytvořeného pomocí Meshy odešlete místo toho input_task_id, které funguje, dokud Meshy uchovává zdrojový úkol (viz Uchování assetů). Chcete-li model použít poté, stáhněte si ho před expires_at a odešlete vlastní kopii.

Zda vykreslit také náhled s průhledným pozadím (RGBA), vráceným v alpha_thumbnail_url při získání úkolu. thumbnail_url se nemění.

Tiskárna, kterou plánujete použít. Určuje minimální tloušťku stěny, o kterou se oprava snaží. Pokud odešlete velikost tisku bez printer_type, Meshy použije fdm, pokud úkol Analyzovat tisknutelnost v input_task_id neposkytne tiskárnu.

Dostupné hodnoty:

• fdm: filament, minimální tloušťka stěny 1,0 mm
• sla: pryskyřice, minimální tloušťka stěny 0,8 mm
• full_color: plná barva, minimální tloušťka stěny 2,0 mm

Jakákoli jiná hodnota vrátí 400.

Výška tisku v milimetrech, od 1 do 1000. Hodnota mimo rozsah vrátí 400. Odešlete buď toto, nebo intended_print_longest_side_mm, ne obojí.

Funguje pouze se vstupem GLB. Pro model_url, který není souborem .glb, odešlete místo toho intended_print_longest_side_mm.

Délka nejdelší strany tisku v milimetrech, od 1 do 1000. Hodnota mimo rozsah vrátí 400. Funguje s každým vstupním formátem.

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

• Chybějící parametr: Nebylo odesláno ani input_task_id, ani model_url.
• Neplatné UUID: input_task_id není platné UUID.
• Neplatná URL adresa modelu: model_url je špatně formátovaná, používá nepodporované schéma nebo má nepodporovanou příponu souboru.
• Soubor modelu je příliš velký: Soubor model_url má přes 400 MB z adresy URL http nebo https, nebo přes 100 MB jako Data URI.
• Příliš mnoho ploch: Soubor model_url je soubor GLB, glTF, FBX nebo OBJ o velikosti přes 100 MB s více než 10 000 000 plochami. Snižte počet ploch a soubor odešlete znovu.
• ASCII FBX přes 100 MB: Soubor model_url je ASCII FBX o velikosti přes 100 MB. Odešlete ho jako binární FBX nebo GLB.
• Nečitelný soubor modelu: Soubor model_url má přes 100 MB a Meshy nedokáže přečíst jeho hlavičku. Jde například o GLB nebo glTF komprimovaný pomocí Draco, nebo binární FBX starší než 7.1.
• Hlavička modelu je příliš komplexní: Soubor model_url má přes 100 MB a jeho hlavička obsahuje příliš mnoho sítí, uzlů nebo záznamů ke kontrole. Snižte počet objektů v souboru a odešlete ho znovu.
• Soubor modelu nelze stáhnout: model_url vrátila chybu, nejčastěji proto, že vypršela platnost podepsané URL adresy pro stažení z Meshy. Opětovné čtení úkolu vrátí stejnou URL adresu se stejnou platností. Odešlete vlastní kopii souboru, nebo odešlete input_task_id, dokud Meshy uchovává zdrojový úkol.
• Úkol nebyl úspěšně dokončen: Úkol input_task_id stále čeká, probíhá nebo selhal.
• Chybějící GLB: Úkol input_task_id nemá žádný GLB model k opravě.
• Neplatná velikost tisku: intended_print_height_mm nebo intended_print_longest_side_mm je mimo rozsah 1 až 1000, nebo požadavek obsahuje obojí.
• Neznámý typ tiskárny: printer_type není fdm, sla ani full_color.
• Výška u modelu jiného než GLB: Požadavek obsahuje intended_print_height_mm a model_url, který není souborem .glb. Odešlete místo toho intended_print_longest_side_mm.
• Tento model nelze upravit podle výšky: Při požadované výšce, nebo výchozí hodnotě 150 mm, by nejdelší strana modelu byla mimo rozsah 1 až 1 000 mm. Stává se to také, když je model plochý, nebo když Meshy nedokáže určit jeho velikost. Odešlete místo toho intended_print_longest_side_mm. U model_url ve formátu .glb a u některých úkolů input_task_id to Meshy zjistí až po zahájení úkolu, a úkol pak skončí jako FAILED.
• Nepoužitelná velikost STL: Požadavek obsahuje printer_type bez velikosti a Meshy nedokáže přečíst vlastní nejdelší stranu souboru .stl, nebo je mimo rozsah 1 až 1 000 mm. Odešlete intended_print_longest_side_mm.

Opravte požadavek a odešlete ho znovu. Viz Chyby.

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

Například:

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

input_task_id je model typu bas-relief, který tento koncový bod nedokáže opravit. Zpráva zní This model type does not support this operation. Odešlete jiný model.

Úkol input_task_id neexistuje nebo patří jinému uživateli. Zkontrolujte ID a použijte API klíč z účtu, který úkol vytvořil.

Překročili jste limit rychlosti, nebo máte příliš mnoho čekajících úkolů. Počkejte a zkuste to znovu. Viz Limity rychlosti.

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

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

Číslo stránky, kterou chcete vrátit, počínaje 1.

Počet úloh na stránku, až 100.

Pořadí řazení.

Dostupné hodnoty:

• +created_at: nejstarší první
• -created_at: nejnovější první

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

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

Typ úlohy, vždy print-repair.

Stav úlohy, jedna z hodnot PENDING, IN_PROGRESS, SUCCEEDED, FAILED nebo CANCELED.

Jak velká část úlohy je hotová, v procentech. Je 0, dokud úloha nezačne, a 100, když uspěje.

Počet úloh před touto ve frontě. Hodnota má smysl pouze tehdy, když je úloha ve stavu PENDING.

Čas vytvoření úlohy, v milisekundách Unixu.

Čas zahájení úlohy, v milisekundách Unixu. Je 0, dokud úloha nezačne.

Čas dokončení úlohy, v milisekundách Unixu. Je 0, dokud úloha neskončí.

Čas, kdy vyprší platnost výsledku úlohy, v milisekundách Unixu. Je 0, dokud úloha neskončí.

Podrobnosti o chybě, pokud úloha selže. Je null, pokud úloha neselhala. Viz Chyby.

URL adresy pro stažení opraveného modelu. Obsahuje pouze klíč odpovídající vstupnímu formátu. Formát, který úloha nevygenerovala, nemá žádný klíč, nikoli prázdný řetězec.

URL adresa pro stažení náhledového obrázku opraveného modelu.

URL adresa pro stažení verze thumbnail_url s průhledným pozadím (RGBA). Přítomno pouze tehdy, když jste úlohu vytvořili s alpha_thumbnail: true a Meshy vykreslilo průhledný náhled.

Vždy prázdné pole. Oprava zachovává pouze vstupní geometrii a textury znovu nezapéká.

Počet kreditů, které úloha spotřebovala. Je 10, když je úloha ve stavu SUCCEEDED, a 0 u úlohy ve stavu FAILED, protože Meshy při selhání úlohy kredity vrací.

Tiskárna a velikost, které oprava použila, ať už jste je poslali vy, nebo je Meshy znovu použilo z úlohy Analyzovat tisknutelnost. Přítomno u opravy tloušťky stěny od začátku, včetně doby, kdy je úloha ve stavu PENDING. Hodnota, kterou Meshy ještě nezná, je null.

Co oprava tloušťky stěny provedla. Přítomno poté, co oprava tloušťky stěny uspěje.