Opravit tisknutelnost API

ID úlohy, kterou vlastníte a která byla úspěšná. Podporované typy úloh: Obrázek na 3D, Více obrázků na 3D, Text na 3D, Remesh, Retexturování a Analyzovat tisknutelnost. Úloha musí mít stav SUCCEEDED a musela vytvořit asset GLB.

Analyzační úloha, která zkontrolovala tloušťku stěny, také předává svou tiskárnu a velikost, takže oprava kontroluje tloušťku stěny a zesiluje tenké stěny, i když ani jedno z toho neodešlete; printer_type nebo velikost tisku, kterou odešlete, tuto hodnotu přepíše. Analyzační úlohy vytvořené z model_url typu .stl, .fbx nebo .gltf nejsou přijímány: místo toho odešlete soubor jako model_url.

URL 3D modelu, který se má opravit. Podporované formáty: .glb, .gltf, .obj, .fbx, .stl. Použijte URL http nebo https, nebo base64 data: URL pro GLB (data:model/gltf-binary;base64,...) nebo glTF (data:model/gltf+json;base64,...). Soubory .obj, .fbx a .stl musí být odeslány jako URL http nebo https.

Maximální velikost souboru: 400 MB pro URL http nebo https, 100 MB pro URI data:.

Soubor GLB, glTF, FBX nebo OBJ přesahující 100 MB může mít nejvýše 10 000 000 ploch. Plochy se počítají jako trojúhelníky: čtyřúhelník se počítá jako 2 a síť vykreslená vícekrát se počítá jednou za kopii. Nad 100 MB musí být soubor FBX binární FBX 7.1 nebo novější a soubor GLB nebo glTF nesmí používat kompresi Draco.

URL ke stažení Meshy (assets.meshy.ai/…?Expires=…&Signature=…) jsou podepsané a přestanou fungovat v okamžiku expires_at dané úlohy; opětovné načtení úlohy je neobnoví. U modelu vygenerovaného pomocí Meshy místo toho předejte input_task_id. Funguje to po dobu, po kterou je zdrojová úloha uchovávána (viz Uchování assetů). Chcete-li model znovu použít poté, stáhněte jej před expires_at a odešlete vlastní kopii.

Je-li nastaveno na true, úloha navíc vykreslí verzi náhledu s průhledným pozadím (RGBA) a vrátí ji jako alpha_thumbnail_url v odpovědi GET. Stávající pole thumbnail_url zůstává beze změny.

Tiskárna, kterou plánujete použít. Nastavuje minimální tloušťku stěny, ke které oprava směřuje. Výchozí je fdm, pokud odešlete velikost tisku bez tohoto parametru, pokud analyzační úloha předaná jako input_task_id nedodá 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: full-color, minimální tloušťka stěny 2,0 mm.

Výška tisku v milimetrech. Rozsah: [1, 1000]. Zaokrouhleno na nejbližší milimetr. Pouze pro vstup GLB.

Délka nejdelší strany tisku v milimetrech. Rozsah: [1, 1000]. Zaokrouhleno na nejbližší milimetr. Funguje s každým vstupním formátem.

Požadavek byl nepřijatelný. Časté příčiny:

• Chybějící parametr: nebylo zadáno ani input_task_id, ani model_url.
• Neplatné UUID: input_task_id není platné UUID.
• Neplatná URL modelu: model_url je chybně formátované, používá nepodporované schéma nebo má nepodporovanou příponu souboru.
• Soubor modelu je příliš velký: tělo model_url přesáhlo 400 MB (URL http nebo https) nebo 100 MB (URI data:).
• Příliš mnoho ploch: model_url je soubor GLB, glTF, FBX nebo OBJ přesahující 100 MB s více než 10 000 000 plochami. Snižte počet ploch a soubor odešlete znovu.
• ASCII FBX přesahující 100 MB: model_url je ASCII FBX přesahující 100 MB. Odešlete jej jako binární FBX nebo GLB.
• Nečitelný soubor modelu: model_url přesahuje 100 MB a jeho hlavičku nelze přečíst, například u GLB nebo glTF komprimovaného pomocí Draco, nebo binárního FBX staršího než 7.1.
• Hlavička modelu je příliš složitá: model_url přesahuje 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 jej znovu.
• Soubor modelu se nepodařilo stáhnout: model_url vrátil chybu, nejčastěji proto, že platnost podepsané URL ke stažení z Meshy vypršela. Opětovné načtení úlohy vrátí stejnou URL se stejnou platností, proto odešlete vlastní kopii souboru, nebo použijte input_task_id, dokud je zdrojová úloha stále uchovávána.
• Úloha nebyla úspěšná: odkazovaná úloha je stále čekající, probíhá nebo selhala.
• Chybějící GLB: odkazovaná úloha nemá žádný asset GLB k opravě.
• Neplatná velikost tisku: intended_print_height_mm nebo intended_print_longest_side_mm je mimo rozsah [1, 1000], nebo byly odeslány obě hodnoty.
• Neznámý typ tiskárny: printer_type není fdm, sla ani full_color.
• Výška na modelu, který není GLB: intended_print_height_mm bylo odesláno s model_url, které není .glb. Místo toho použijte intended_print_longest_side_mm.
• Nelze určit velikost tohoto modelu podle výšky: při požadované výšce (nebo výchozích 150 mm) by nejdelší strana modelu byla mimo rozsah [1, 1000] mm, model je plochý, nebo jeho velikost nelze určit. Místo toho použijte intended_print_longest_side_mm. U model_url typu .glb a některých úloh input_task_id se toto zjistí až po spuštění úlohy a úloha pak skončí stavem FAILED.
• Velikost STL nepoužitelná: printer_type bylo odesláno bez velikosti a vlastní nejdelší strana souboru .stl nelze přečíst nebo je mimo rozsah [1, 1000] mm. Odešlete intended_print_longest_side_mm.

Autentizace selhala. Zkontrolujte prosím svůj API klíč.

Časté příčiny:

• Bezplatný plán: vytvoření úlohy vyžaduje placený plán. Upgradujte na stránce předplatného.
• Nedostatek kreditů: byl dosažen limit kreditů pracovního prostoru.

Odkazovaná úloha neexistuje nebo ji vlastní jiný uživatel.

Překročili jste svou kvótu čekajících úloh nebo limit rychlosti.

ID úkolu opravy tisknutelnosti, který se má načíst.

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

Číslo stránky pro stránkování. Začíná a výchozí hodnota je 1.

Limit velikosti stránky. Výchozí hodnota je 10 položek. Maximální povolená hodnota je 100 položek.

Pole, podle kterého se má řadit. Dostupné hodnoty:

• +created_at: Řadit podle času vytvoření vzestupně.
• -created_at: Řadit podle času vytvoření sestupně.

Jedinečný identifikátor úlohy opravy tisknutelnosti, kterou chcete streamovat.

Jedinečný identifikátor úlohy. Ačkoli jako implementační detail používáme pro id úloh k-sortable UUID, neměli byste dělat žádné předpoklady o formátu id.

Typ úlohy repair-printability. Hodnota je print-repair.

Stav úlohy. Možné hodnoty jsou jedna z PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Průběh úlohy. Pokud úloha ještě nezačala, tato vlastnost bude 0. Jakmile úloha uspěje, bude 100.

Počet předcházejících úloh.

Časové razítko vytvoření úlohy, v milisekundách.

Časové razítko spuštění úlohy, v milisekundách. Pokud úloha ještě nebyla spuštěna, tato vlastnost bude 0.

Časové razítko dokončení úlohy, v milisekundách. Pokud úloha ještě není dokončena, tato vlastnost bude 0.

Časové razítko, kdy výsledek úlohy vyprší ze systému, v milisekundách. 0, pokud úloha ještě není dokončena.

Informace o chybě, pokud úloha selhala. Tato vlastnost je null, pokud úloha neselhala. Více podrobností najdete v sekci Chyby.

Stažitelné URL adresy k opravenému 3D modelu. Vyplněno je pouze pole odpovídající vstupnímu formátu; ostatní pole formátů jsou prázdné řetězce.

URL adresa náhledového obrázku vykresleného z opraveného modelu.

Stažitelná URL adresa k verzi thumbnail_url s průhledným pozadím (RGBA). Přítomno pouze tehdy, pokud byla úloha vytvořena s alpha_thumbnail: true a průhledný náhled byl úspěšně vykreslen; jinak je toto pole vynecháno.

Vždy prázdné pole. Oprava zachovává pouze vstupní geometrii a znovu nepeče textury.

Počet kreditů spotřebovaných touto úlohou. 10, jakmile úloha dosáhne stavu SUCCEEDED. U úloh se stavem FAILED vrací 0 (kredity jsou při selhání vráceny).

Tiskárna a velikost, které oprava použila, ať už byly odeslány nebo znovu použity z úlohy analýzy. Přítomno u opravy tloušťky stěny od začátku (PENDING); hodnoty, které ještě nejsou známé, jsou null.

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