Auto Split API

ID úlohy, jejíž model se má rozdělit. Úloha musí mít stav SUCCEEDED. Fungují tyto typy úloh:

• Obrázek na 3D
• Více obrázků na 3D
• Text na 3D, úloha preview nebo refine
• Retexturování
• Remesh
• Převést
• Změnit velikost

Model musí být vygenerován pomocí Meshy 6 nebo Meshy 7, tedy s ai_model nastaveným na meshy-6-lite, meshy-6, meshy-7, meshy-7.1 nebo latest. Modely Smart Topology (meshy-t2 a meshy-t2.5) nejsou podporovány. U úlohy refine, Retexturování, Remesh, Převést nebo Změnit velikost platí toto pravidlo pro model, ze kterého úloha vycházela. Úloha Retexturování, Remesh, Převést nebo Změnit velikost vytvořená z nahraného modelu vrátí 400.

Model může mít nejvýše 8 000 000 ploch (faces). Model s více plochami vrátí 400. V takovém případě na něm nejprve spusťte úlohu Remesh a místo toho odešlete ID úlohy Remesh.

Můžete rozdělit i texturovaný model. Chcete-li zachovat jeho texturu na jednotlivých částech, odešlete keep_texture: true.

Jak rozdělit model na části.

Dostupné hodnoty:

• auto: Meshy zvolí řezy sám a ignoruje prompt. prompt delší než 600 znaků i tak vrátí 400.
• by_parts: Meshy řeže podél strukturálních částí, které uvedete v prompt, například hlava, paže a trup.
• by_color: Meshy řeže podél barevných oblastí, které uvedete v prompt. Meshy nachází tyto oblasti ve zdrojovém obrázku, nikoli v textuře vstupního modelu. Vstup musí být vygenerován z nahraného obrázku pomocí funkce Obrázek na 3D nebo Více obrázků na 3D. Jiné vstupy vrátí 400. U funkce Více obrázků na 3D Meshy použije první zdrojový obrázek.

Formáty souborů, které se mají vygenerovat. Meshy vždy vygeneruje glb a vrátí ho v model_urls, a navíc další formáty, které uvedete.

Dostupné hodnoty:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Každý formát kromě stl podporuje objekty scény a uchovává každou část jako samostatný objekt. Soubor STL nemůže obsahovat samostatné objekty, takže Meshy sloučí části do jednoho pevného tělesa uspořádaného podle layout. Chcete-li získat části, které lze ve slicer vybírat samostatně, vyžádejte si 3mf.

Při keep_texture: true obsahují texturu tyto formáty:

• glb, fbx, usdz a blend: Textura je přímo v souboru.
• obj: Textura je v souboru materiálu, který model_urls vrací pod klíčem mtl.
• stl a 3mf: Soubor obsahuje pouze geometrii, bez textury.

Jak Meshy uspořádá části, ve všech formátech souborů i v miniatuře.

Dostupné hodnoty:

• assembled: Meshy ponechá části tam, kde byly ve zdrojovém modelu.
• on_plate: Meshy rozloží části naplocho a rozmístí je po tiskové podložce, připravené k nařezání ve slicer. Jde o stejné uspořádání jako v zobrazení On Plate ve webové aplikaci.

V obou uspořádáních Meshy před exportem odstraní jakýkoli zhroucený úzký proužek nebo bodu podobný útvar, který po řezu zbyde, takže každá část, kterou dostanete, je tisknutelná. Formáty podporující objekty scény obsahují jeden objekt na část, zatímco stl sloučí části do jednoho pevného tělesa.

Zda zachovat na částech texturu vstupního modelu. true přiřadí každé části texturu vstupu a úloha vrátí mapy v texture_urls. false přiřadí každé části plochou barvu vrcholů (vertex color).

Při true trvá úloha přibližně dvakrát déle a spotřeba kreditů se nemění. Netexturovaný vstup se rozdělí stejně jako při false. Pokud Meshy nedokáže texturu zachovat, úloha selže s chybovým kódem textured_split_refused. Viz Chyby.

Zda přidat na každém řezu čepové spoje (mortise-and-tenon), aby se vytištěné části k sobě daly spojit.

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

• Chybějící prompt: mode je by_parts nebo by_color a prompt chybí.
• Prompt nepopisuje žádné rozdělení nebo uvádí příliš mnoho částí: Prompt žádá o zachování modelu v jednom kuse, nebo pojmenovává více než 10 částí. by_parts a by_color přijímají 1 až 10 pojmenovaných částí. Meshy za tento požadavek neúčtuje kredity.
• Nepodporovaná vstupní úloha: input_task_id není úspěšně dokončená úloha podporovaného typu, vygenerovaná pomocí Meshy 6 nebo Meshy 7.
• Žádný referenční obrázek: mode je by_color a vstup nebyl vygenerován z nahraného obrázku.
• Spoj mimo rozsah: connector_size nebo connector_height je mimo rozsah 0.1 až 0.8.

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

Platí jedno z následujícího:

• Moderování obsahu zablokovalo prompt. Zpráva je explicit content nebo prohibited content. Změňte prompt a zkuste to znovu.
• input_task_id je model typu basreliéf, který tento koncový bod nedokáže rozdělit. Zpráva je This model type does not support this operation. Odešlete jiný model.

input_task_id neexistuje nebo nepatří k vašemu účtu. Zkontrolujte ID a použijte API klíč z účtu, který úlohu vytvořil.

Překročili jste svůj limit rychlosti. Počkejte a zkuste to znovu. Viz Limity rychlosti.

Požadavky by_parts a by_color navíc sdílejí limit čtení promptu ve výši 12 požadavků za minutu na účet.

Rozdělování podle promptu (by_parts a by_color) je dočasně nedostupné. Zkuste to později, nebo odešlete mode: "auto", který funguje i nadále. Meshy za tento požadavek neúčtuje kredity.

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

ID úlohy, která se má smazat.

Číslo stránky, která se má vrátit. Začíná na 1 a je to i výchozí hodnota.

Počet úkolů na stránku, maximálně 100. Výchozí hodnota je 10. Meshy vyšší hodnotu považuje za 100.

Pořadí řazení.

Dostupné hodnoty:

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

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

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

Typ úlohy, vždy print-split.

Odkazy ke stažení rozděleného modelu, jeden pro každý vámi požadovaný formát. Formát, který jste nepožadovali, nemá žádný klíč. Formáty podporující objekty scény uchovávají každý díl jako samostatný objekt, zatímco stl sloučí díly do jednoho pevného tělesa.

Odkaz ke stažení náhledového obrázku rozděleného modelu v požadovaném layout. Pokud díly zachovávají texturu, náhled ji zobrazuje. Jinak má každý díl svou vlastní barvu.

Textury rozděleného modelu, jako pole s jedním objektem. Všechny díly sdílejí tyto mapy. Přítomné pouze pokud je keep_texture nastaveno na true a vstupní model má texturu.

Odkaz ke stažení verze thumbnail_url s průhledným pozadím (RGBA). Přítomné pouze po úspěšném dokončení úlohy, pokud Meshy vykreslil průhledný náhled.

Zda Meshy ignoroval prompt. Je true, pokud prompt v požadavku typu by_parts nebo by_color nepojmenoval žádné díly, takže Meshy rozdělil model automaticky. Názvy dílů ve výsledku pak pocházejí od Meshy, nikoli od vás. Přítomné od stavu PENDING dál. Meshy jej vynechává u úloh auto a kdykoli se řídil promptem.

Počet tisknutelných dílů, které rozdělení vytvořilo. Formáty podporující objekty scény obsahují jeden objekt na díl. stl sloučí díly do jednoho pevného tělesa, ale part_count je přesto počítá. Před exportem Meshy odstraní zhroucené drobky, které se nemohou stát tisknutelným dílem, a nepočítá je.

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

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

Počet úloh před touto úlohou ve frontě. Hodnota má smysl pouze dokud je úloha ve stavu PENDING.

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

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

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

Čas vypršení platnosti výsledku úlohy, v milisekundách Unix. Je 0, dokud úloha neskončí.

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

Pokud bezpečnostní kontrola odmítne vstupní model, úloha selže s task_error.type nastaveným na invalid_input a task_error.code nastaveným na provider_content_refused. Odešlete jiný model. Viz Chyby.

S keep_texture: true, pokud Meshy nedokáže zachovat texturu, úloha selže s task_error.code nastaveným na textured_split_refused. Viz Chyby.

Počet kreditů, které úloha spotřebovala. Je vždy přítomné. Je 10 poté, co Meshy úlohu přijme, a 0 u úlohy se stavem FAILED, protože Meshy vrátí kredity, pokud úloha selže. Smazání úlohy ve stavu PENDING je rovněž vrátí.