Retexture API

Vyžadováno, pokud neodešlete model_url. ID úlohy, která vytvořila 3D model k texturování, například úlohy Text na 3D, Obrázek na 3D, Remesh nebo Retexturování. Úloha musí být vytvořena vámi pomocí API a mít stav SUCCEEDED. Meshy texturuje GLB soubor dané úlohy.

S meshy-n1 může mít model úlohy nejvýše 7 999 999 ploch, počítaných jako trojúhelníky (čtyřúhelník se počítá jako 2).

Vyžadováno, pokud neodešlete input_task_id. Model k texturování, jako veřejná URL adresa nebo data URI. Pokud odešlete obojí, Meshy použije input_task_id.

Model musí být soubor GLB, glTF, OBJ, FBX nebo STL o velikosti nejvýše 400 MB z http nebo https URL adresy, nebo 100 MB jako data URI. Pro data URI použijte MIME type application/octet-stream, například data:application/octet-stream;base64,<vaše base64-kódovaná data modelu>.

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íť nakreslená 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.

S meshy-n1 může mít model nejvýše 7 999 999 ploch, počítaných jako trojúhelníky (čtyřúhelník se počítá jako 2), bez ohledu na velikost souboru.

Vyžadováno, pokud neodešlete image_style_url nebo multiview_image_urls. Text popisující požadovanou texturu, až 800 znaků. Delší text vrátí 400. S meshy-n1 odeslání bez image_style_url vrátí 400.

Vyžadováno, pokud neodešlete text_style_prompt nebo multiview_image_urls. 2D obrázek, jehož styl textura napodobuje, jako veřejná URL adresa nebo data URI (data:image/jpeg;base64,<vaše base64-kódovaná data obrázku>). Pokud odešlete text_style_prompt i image_style_url, Meshy použije image_style_url.

Obrázek musí být soubor .jpg, .jpeg, .png nebo .webp o velikosti nejvýše 20 MB a nejméně 32 pixelů na každé straně.

Textura nemusí dobře sedět, pokud má objekt na obrázku velmi odlišný tvar od modelu. S meshy-n1 Meshy považuje obrázek za pohled zepředu.

Vyžadováno, pokud neodešlete text_style_prompt nebo image_style_url. Jeden až čtyři obrázky téhož objektu z různých pohledů. První obrázek je hlavní (přední) pohled. Na pořadí ostatních pohledů (vlevo, vzadu, vpravo) nezáleží. Prázdné pole nebo více než čtyři obrázky vrátí 400.

Každý obrázek dodržuje stejná pravidla formátu a velikosti jako image_style_url, nejvýše 20 MB na obrázek. multiview_image_urls nelze kombinovat s text_style_prompt ani image_style_url.

multiview_image_urls vyžaduje explicitní ai_model s hodnotou meshy-7 nebo meshy-n1. Jakýkoli jiný ai_model, včetně výchozího latest, vrátí 400.

AI model, který generuje texturu.

Dostupné hodnoty:

• meshy-6-lite
• meshy-6
• meshy-7
• meshy-n1: 2K textura základní barvy pouze z referenčních obrázků. Žádný textový prompt, žádné PBR mapy, žádné 4K ani 8K. Až 7 999 999 ploch.
• latest: Meshy 7

Zda zachovat UV rozvržení modelu místo generování nového.

• U modelu vygenerovaného Meshy, z input_task_id nebo model_url, který odkazuje na výstup Meshy, použijte true pro opětovné použití jeho optimalizovaného UV rozvržení.
• U modelu nahraného odjinud použijte true pro zachování UV souřadnic, které jsou již dobré. Ponechte false, aby Meshy vygenerovalo nové UV souřadnice, což je vhodné pro model bez správného UV mapování.

Zda kromě základní barvy generovat také PBR mapy (metalíza, drsnost a normálová mapa). S meshy-6 Meshy také generuje emisní mapu, kromě případu, kdy je texture_resolution nastaveno na 8k. meshy-6-lite, meshy-7 a latest emisní mapu negenerují. S meshy-n1 hodnota true vrátí 400.

Velikost textury základní barvy. Vyšší rozlišení zachycují více detailů povrchu.

Dostupné hodnoty:

• 2k: 2048 × 2048 pixelů
• 4k: 4096 × 4096 pixelů
• 8k: 8192 × 8192 pixelů

4k a 8k vyžadují ai_model s hodnotou meshy-6, meshy-7 nebo latest. S meshy-6-lite nebo meshy-n1 vrátí 400. Při 8k Meshy negeneruje emisní mapu.

Místo toho použijte texture_resolution. true je totéž jako texture_resolution: "4k". Pokud odešlete obojí, Meshy použije texture_resolution.

Zda odstranit odlesky a stíny z textury základní barvy. Výsledek funguje lépe při vašem vlastním osvětlení.

Meshy to uplatňuje pouze s meshy-6, při texture_resolution nastaveném na 2k nebo 4k. S meshy-7 nebo latest, nebo při 8k, Meshy tento parametr přijme, ale ignoruje jej. S meshy-6-lite nebo meshy-n1 odeslání s jakoukoli hodnotou vrátí 400.

Souborové formáty, které se mají vygenerovat. Meshy generuje pouze formáty, které uvedete, což může úlohu zkrátit. Pokud parametr vynecháte, Meshy vygeneruje všechny formáty kromě 3mf.

Dostupné hodnoty:

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

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

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

• Chybějící parametr: Nebylo odesláno ani model_url, ani input_task_id.
• Chybějící styl: Nebylo odesláno žádné z text_style_prompt, image_style_url ani multiview_image_urls.
• Konfliktní vstupy stylu: multiview_image_urls bylo odesláno spolu s text_style_prompt nebo image_style_url.
• Nepodporovaný model pro vícepohledové zobrazení: multiview_image_urls bylo odesláno bez explicitního ai_model s hodnotou meshy-7 nebo meshy-n1.
• Nepodporovaná volba pro Meshy N1: meshy-n1 bylo odesláno s enable_pbr: true, remove_lighting, texture_resolution nastaveným na 4k nebo 8k, hd_texture: true bez texture_resolution, nebo text_style_prompt bez image_style_url.
• Příliš mnoho trojúhelníků pro Meshy N1: S meshy-n1 má 3D model více než 7 999 999 trojúhelníků. Snižte počet trojúhelníků nebo použijte jiný ai_model.
• Model příliš komplexní pro Meshy N1: S meshy-n1 je soubor model_url příliš komplexní na to, aby Meshy spočítalo jeho trojúhelníky. Snižte počet trojúhelníků a soubor odešlete znovu.
• Vypršel časový limit počítání trojúhelníků: S meshy-n1 trvalo spočítání trojúhelníků souboru model_url příliš dlouho. Zkuste to znovu nebo zmenšete velikost modelu.
• Neplatná vstupní úloha: input_task_id není úspěšná úloha podporovaného typu.
• Neplatný formát modelu: Soubor model_url má nepodporovanou příponu.
• Nedostupná URL adresa: Meshy nemůže stáhnout soubor model_url, obrázek image_style_url nebo obrázek z multiview_image_urls.
• Soubor modelu je příliš velký: Soubor model_url přesahuje 400 MB z http nebo https URL adresy, nebo 100 MB jako data URI.
• Příliš mnoho ploch: Soubor model_url je větší než 100 MB a má více než 10 000 000 ploch. Snižte počet ploch a soubor odešlete znovu.
• ASCII FBX nad 100 MB: Soubor model_url je ASCII FBX větší než 100 MB. Odešlete jej jako binární FBX nebo GLB.
• Nečitelný soubor modelu: Soubor model_url je větší než 100 MB a Meshy nemůže přečíst jeho hlavičku. Například jde o GLB nebo glTF komprimovaný pomocí Draco, nebo binární FBX starší než 7.1.
• Hlavička modelu příliš komplexní: Soubor model_url je větší než 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.
• Obrázek je příliš velký: Obrázek image_style_url nebo obrázek z multiview_image_urls přesahuje 20 MB.

S meshy-n1 model, který Meshy nemůže zkontrolovat před zahájením úlohy, například soubor STL, zde není odmítnut. Pokud má více než 7 999 999 trojúhelníků, úloha selže a Meshy vrátí jeho kredity.

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

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

Například:

• Nedostatek kreditů: Účet nemá dostatek kreditů na tuto úlohu, nebo účet dosáhl limitu kreditů. Zkontrolujte svůj zůstatek kreditů a zkuste to znovu.
• Bezplatný plán: 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:

• Moderace obsahu zablokovala prompt nebo vstupní obrázek. Změňte vstup a zkuste to znovu.
• input_task_id je model typu basreliéf, který tento koncový bod nemůže retexturovat. Zpráva zní This model type does not support this operation. Odešlete jiný model.

input_task_id neodpovídá žádné z vašich úloh. Zkontrolujte ID úlohy a odešlete požadavek znovu.

Překročili jste svůj limit rychlosti. 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, až do 255. Vyšší hodnota vrátí 400.

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

Pořadí řazení.

Dostupné hodnoty:

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

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

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

Typ úlohy, vždy retexture.

Odkazy ke stažení texturovaného 3D modelu, jeden pro každý formát souboru.

Textový prompt, se kterým jste úlohu vytvořili.

Stylový obrázek, se kterým jste úlohu vytvořili.

Odkazy ke stažení referenčních obrázků z více pohledů, se kterými jste úlohu vytvořili. Přítomno pouze tehdy, když jste úlohu vytvořili s multiview_image_urls.

Odkaz ke stažení miniatury modelu.

Odkaz ke 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 vyrenderovalo průhledný náhled.

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

Čas, kdy úloha začala, v milisekundách Unix. Je 0, dokud úloha nezačne.

Čas, kdy byla úloha vytvořena, v milisekundách Unix.

Čas, kdy vyprší platnost výsledků úlohy, v milisekundách Unix.

Čas, kdy úloha skončila, v milisekundách Unix. Je 0, dokud úloha neskončí.

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

Odkazy ke stažení vygenerovaných textur, jako pole objektů. Pole obvykle obsahuje jeden objekt. Každý objekt má tato pole:

Počet úloh před touto ve frontě. Přítomno pouze, pokud je úloha PENDING; pole se vynechá, pokud je hodnota 0.

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

Počet kreditů, které úloha spotřebovala. Přítomno, pokud je stav PENDING, IN_PROGRESS nebo SUCCEEDED. U úlohy se stavem FAILED je 0, protože Meshy v takovém případě kredity vrátí.