Retexture API

ID dokončené úlohy Obrázek na 3D nebo Text na 3D, kterou chcete retexturovat. Tato úloha musí být jednou z následujících: Text na 3D Preview, Text na 3D Refine, Obrázek na 3D nebo Remesh. Kromě toho musí mít stav SUCCEEDED.

Poskytněte 3D model, který má Meshy texturovat. Podporované formáty: .glb, .gltf, .obj, .fbx, .stl.

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

Soubor GLB, glTF, FBX nebo OBJ o velikosti přes 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 každou kopii. Nad 100 MB musí být soubor FBX ve formátu binary FBX 7.1 nebo novějším a soubor GLB nebo glTF nesmí používat kompresi Draco.

Model lze poskytnout dvěma způsoby:

• Veřejně dostupná URL: URL adresa přístupná z veřejného internetu.
• Data URI: Datová URI modelu kódovaná v base64. Použijte MIME type application/octet-stream. Příklad: data:application/octet-stream;base64,<vaše data modelu zakódovaná v base64>.

Popište textem požadovaný styl textury objektu. Maximálně 800 znaků.

Poskytněte 2D obrázek, kterým se bude řídit proces texturování. V současné době podporujeme formáty .jpg, .jpeg, .png a .webp.

Maximální velikost souboru: 20 MB.

Obrázek lze poskytnout dvěma způsoby:

• Veřejně dostupná URL: URL adresa přístupná z veřejného internetu
• Data URI: Datová URI obrázku kódovaná v base64. Příklad datové URI: data:image/jpeg;base64,<vaše data obrázku zakódovaná v base64>

Poskytněte 1 až 4 obrázky zobrazující stejný objekt z různých pohledů, podle kterých se bude řídit texturování. První obrázek je primární (přední) pohled; pořadí zbývajících pohledů (vlevo, vzadu, vpravo) nehraje roli.

Každý prvek přijímá stejné formáty jako image_style_url (veřejně dostupná URL adresa nebo datová URI v base64, .jpg/.jpeg/.png/.webp).

Maximální velikost souboru: 20 MB na obrázek.

ID AI modelu použitého pro retexturování. Dostupné hodnoty: meshy-6-lite, meshy-6, meshy-7, latest (Meshy 7).

Zachová stávající UV rozvržení modelu místo generování nového.

• Pokud retexturujete model, který vygenerovalo Meshy (přes input_task_id, nebo model_url odkazující na výstup Meshy), nastavte tuto hodnotu na true, aby se znovu použilo jeho optimalizované UV rozvržení.
• Pokud retexturujete nahraný model třetí strany, nastavte true, pokud již má dobré UV, které chcete zachovat, nebo ponechte false, aby Meshy vytvořilo nové UV rozvržení (nejlepší volba pro modely bez správného UV mapování).

Vygeneruje PBR mapy (metallic, roughness, normal) navíc k základní barvě. Pokud je ai_model nastaven na meshy-6, je zahrnuta i emisní mapa, kromě případu texture_resolution: 8k. meshy-6-lite, meshy-7 a latest emisní mapu nevytvářejí.

Rozlišení textury základní barvy. Jedna z hodnot 2k (2048×2048), 4k (4096×4096) nebo 8k (8192×8192). Vyšší rozlišení zachycují více povrchových detailů.

Místo toho použijte texture_resolution — odpovídá hodnotě texture_resolution: "4k". Pokud jsou nastaveny oba parametry, má přednost texture_resolution.

Odstraní z textury základní barvy odlesky a stíny, čímž vznikne čistší výsledek, který lépe funguje v nestandardním nastavení osvětlení.

Určuje, které formáty 3D souborů mají být zahrnuty ve výstupu. Vygenerovány a vráceny budou pouze požadované formáty, což může zkrátit dobu dokončení úlohy. Pokud není zadán, jsou zahrnuty všechny podporované formáty.

Dostupné hodnoty: glb, obj, fbx, stl, usdz, 3mf

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

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

• Chybějící parametr: Musí být zadán buď model_url, nebo input_task_id.
• Chybějící styl: Musí být zadán jeden z parametrů text_style_prompt, image_style_url nebo multiview_image_urls.
• Konfliktní vstupy stylu: multiview_image_urls nelze kombinovat s text_style_prompt ani image_style_url.
• Nepodporovaný model pro více pohledů: multiview_image_urls vyžaduje explicitní ai_model: "meshy-7".
• Model není dostupný: ai_model: "meshy-7" a ai_model: "meshy-6-lite" se postupně zavádějí a pro váš účet zatím nemusí být povoleny.
• Neplatná vstupní úloha: input_task_id musí odkazovat na úspěšnou úlohu podporovaného modelu.
• Neplatný formát modelu: model_url odkazuje na soubor s nepodporovanou příponou.
• Nedostupná URL: model_url, image_style_url nebo prvek multiview_image_urls se nepodařilo stáhnout.
• Soubor modelu je příliš velký: Soubor model_url přesahuje 400 MB (URL typu http nebo https) nebo 100 MB (data: URI).
• Příliš mnoho ploch: Soubor model_url má přes 100 MB a obsahuje více než 10 000 000 ploch. Snižte počet ploch a soubor znovu odešlete.
• ASCII FBX přes 100 MB: Soubor model_url je ASCII FBX přes 100 MB. Odešlete jej jako binary FBX nebo GLB.
• Nečitelný soubor modelu: Soubor model_url má přes 100 MB a jeho hlavičku nelze přečíst, například u GLB nebo glTF komprimovaného pomocí Draco nebo u binary FBX staršího než 7.1.
• Hlavička modelu je příliš složitá: 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 jej znovu.
• Obrázek je příliš velký: Obrázek image_style_url nebo prvek multiview_image_urls přesahuje 20 MB.

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

Nedostatek kreditů k provedení této úlohy.

Překročili jste limit rychlosti.

Jedinečný identifikátor úlohy Retexturování, kterou chcete načíst.

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

Číslo stránky pro stránkování.

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

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

Dostupné hodnoty:

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

Jedinečný identifikátor úlohy Retexturování, kterou chcete streamovat.

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

Typ úkolu Retexturování. Hodnota je retexture.

Stažitelná URL adresa na soubor texturovaného 3D modelu vygenerovaného Meshy.

Toto je textový prompt, který byl použit k vytvoření úkolu texturování.

Toto je obrazový vstup, který byl použit k vytvoření úkolu texturování.

Stažitelné URL adresy na referenční obrázky s více pohledy, které byly použity k vytvoření úkolu texturování. Přítomno pouze pokud byl úkol vytvořen s multiview_image_urls.

Stažitelná URL adresa na miniaturu souboru modelu.

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

Průběh úkolu. Pokud úkol ještě nebyl zahájen, tato vlastnost bude 0. Jakmile úkol uspěje, stane se 100.

Časové razítko zahájení úkolu, v milisekundách. Pokud úkol ještě nebyl zahájen, tato vlastnost bude 0.

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

Časové razítko, kdy vyprší platnost výsledku úkolu, v milisekundách.

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

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

Pole objektů URL textur vygenerovaných úkolem. Běžně obsahuje pouze jeden objekt URL textury. Každá URL textury má následující vlastnosti:

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

Podrobnosti o chybě u neúspěšných úkolů. Úplnou referenci objektu task_error najdete v části Chyby.

Počet kreditů spotřebovaných tímto úkolem. Přítomno, když je stav úkolu PENDING, IN_PROGRESS nebo SUCCEEDED. U úkolů se stavem FAILED vrací 0 (kredity jsou v případě neúspěchu vráceny).