Text na 3D API

Toto pole by mělo být při vytváření náhledové úlohy nastaveno na "preview".

Popište, o jaký druh objektu se u 3D modelu jedná. Maximálně 800 znaků.

Určuje typ generování 3D sítě.

Dostupné hodnoty:

• standard: Běžné generování 3D sítě s vysokou úrovní detailů.
• smart-topology: Zvolte model Smart Topology pomocí ai_model (meshy-t2).
• lowpoly (zastaralé): Generuje low-poly síť optimalizovanou pro čistší polygony. Doporučujeme místo toho použít smart-topology.

ID modelu, který se má použít. Dostupné hodnoty závisí na model_type.

Standardní generování (model_type: standard):

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (zastaralé): místo něj použijte meshy-7.1.

Generování pomocí Smart Topology (model_type: smart-topology):

• meshy-t2 (výchozí): model Smart Topology — čistší topology, přirozeně oddělené části, výstup ve formě trojúhelníků a počet ploch, který lze nastavit pomocí target_polycount.

Průchod generování geometrie. 2k spustí Ultra průchod při 2048³; 4k jej spustí při 4096³ pro nejjemnější detaily povrchu.

Dostupné hodnoty: standard, 2k, 4k

Místo toho použijte geometry_resolution. ultra_mode: true odpovídá hodnotě geometry_resolution: "2k".

Určuje, zda povolit fázi remesh. U modelu s nejvyšší kvalitou doporučujeme nastavit should_remesh na false.

Cílový počet polygonů (ploch) ve výstupu. Skutečný počet se může od cíle lišit v závislosti na geometrii.

target_polycount se uplatní ve dvou nezávislých případech:

• Remesh — s should_remesh: true u modelu standard. Síť je remeshována (decimována) přibližně na tento počet. Rozsah 100 až 300 000, výchozí hodnota 30 000. Je-li nastaveno decimation_mode, má přednost a target_polycount se ignoruje.
• Smart Topology — s model_type: smart-topology a ai_model: meshy-t2. Model je vygenerován přímo s tímto počtem ploch; remesh se nespouští a should_remesh není vyžadováno. Rozsah 100 až 15 000, výchozí hodnota 4 000.

Zastaralé. Tento parametr již neovlivňuje výstup.

Pole symmetry_mode řídí chování symetrie během procesu generování modelu.

Platné hodnoty jsou:

• off: Zakáže symetrii.
• auto: Automaticky určí a použije symetrii na základě vstupní geometrie.
• on: Vynutí symetrii během generování.

Určuje pose mode pro generovaný model.

Dostupné hodnoty:

• a-pose: Vygeneruje model v pozici A.
• t-pose: Vygeneruje model v pozici T.
• "" (prázdný řetězec): Není použita žádná konkrétní pozice.

Místo toho použijte pose_mode. Určuje, zda vygenerovat model v pozici A/T.

Není podporováno modelem Meshy-6. Požadavky používající Meshy-6 budou art_style ignorovat a některé kombinace mohou způsobit chyby. Dostupné hodnoty: realistic, sculpture.

Je-li nastaveno na true, vstupní obsah bude automaticky prověřen na potenciálně škodlivý obsah. Pokud je škodlivý obsah zjištěn, úloha nebude pokračovat do fáze generování.

Prověřován bude text z prompt.

Určuje, které formáty 3D souborů mají být zahrnuty do 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áno, jsou zahrnuty všechny podporované formáty.

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

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.

Je-li nastaveno na true, služba pomocí AI vidění automaticky odhadne skutečnou výšku objektu v reálném světě a odpovídajícím způsobem změní velikost modelu. Počátek bude standardně nastaven na bottom, pokud není origin_at výslovně nastaveno.

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

• Chybějící parametr: Chybí povinný parametr (např. prompt, mode).
• Neplatný parametr: art_style není jednou z povolených hodnot.
• Příliš dlouhý prompt: prompt překračuje limit počtu znaků.
• Nepodporovaný model pro low poly: ai_model: "meshy-6-lite" nepodporuje model_type: "lowpoly".
• Nepodporovaný model pro Ultra: geometry_resolution vyžaduje meshy-7.1 nebo latest.

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

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

Překročili jste svůj limit rychlosti.

Toto pole musí být při vytváření refine úlohy nastaveno na „refine“.

Odpovídající ID preview úlohy.

Stav dané preview úlohy musí být SUCCEEDED.

Vygeneruje PBR mapy (metalness, roughness, normal) navíc k základní barevné mapě. Emisní mapa je také zahrnuta, pokud je ai_model nastaven na meshy-6, kromě případu texture_resolution: 8k (emisní mapa se v tomto případě nevytváří). meshy-6-lite, meshy-7.1 a latest emisní mapu nevytvářejí.

Rozlišení základní barevné textury. Jedna z hodnot 2k (2048×2048), 4k (4096×4096) nebo 8k (8192×8192). Vyšší rozlišení zachytí více detailů povrchu. Platí pouze pro mode refine.

Místo toho použijte texture_resolution — ekvivalent hodnoty texture_resolution: "4k". Pokud jsou zadány oba parametry, má přednost texture_resolution.

Zadejte doplňující textový prompt, který bude řídit proces texturování. Maximálně 800 znaků.

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

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

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

ID modelu použitého pro refine.

Dostupné hodnoty:

• meshy-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (zastaralé): místo něj použijte meshy-7.1.

Pokud tento parametr vynecháte, zdědí se model použitý v preview úloze, díky čemuž zůstanou preview a jeho refine po celou dobu na stejném modelu. Explicitní hodnotou toto zdědění přepíšete.

Pokud je nastaveno na true, vstupní obsah bude automaticky prověřen na potenciálně škodlivý obsah. Pokud je škodlivý obsah detekován, úloha nebude pokračovat do fáze generování.

Prověřován bude jak text z texture_prompt, tak obrázek z texture_image_url.

Odstraní zvýraznění a stíny ze základní barevné textury, čímž vznikne čistší výsledek, který lépe funguje při vlastním nastavení osvětlení.

Určuje, které formáty 3D souborů budou 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 parametr vynecháte, budou zahrnuty všechny podporované formáty.

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

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

Pokud je nastaveno na true, služba použije AI vision k automatickému odhadu reálné výšky objektu a odpovídajícím způsobem změní velikost modelu. Počátek bude ve výchozím nastavení bottom, pokud není explicitně nastaven parametr origin_at.

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

• Neplatné ID úlohy: preview_task_id je neplatné nebo neexistuje.
• Úloha není připravena: Preview úloha ještě nebyla úspěšně dokončena.
• Neshoda modelů: AI model preview úlohy není kompatibilní s požadovaným refine modelem.

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

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

Preview úloha zadaná pomocí preview_task_id nebyla nalezena.

Překročili jste limit rychlosti.

Jedinečný identifikátor úlohy Text na 3D, kterou chcete získat.

ID úlohy Text na 3D, 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: Řadit podle času vytvoření vzestupně.
• -created_at: Řadit podle času vytvoření sestupně.

Jedinečný identifikátor úlohy Text na 3D, kterou chcete streamovat.

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

Typ úkolu Text na 3D. Možné hodnoty jsou text-to-3d-preview pro úkoly ve fázi preview a text-to-3d-refine pro úkoly ve fázi refine.

Stažitelná URL adresa souboru texturovaného 3D modelu vygenerovaného Meshy. Vlastnost pro daný formát bude vynechána, pokud daný formát nebyl vygenerován, místo vrácení prázdného řetězce.

Jedná se o nezměněný prompt, který byl použit k vytvoření úkolu.

Zachováno kvůli zpětné kompatibilitě. Toto pole nemá žádný funkční dopad na generované modely.

Nezměněný art_style, který byl použit k vytvoření úkolu preview. Není podporováno Meshy-6.

Zachováno kvůli zpětné kompatibilitě. Toto pole nemá žádný funkční dopad na generované modely.

Dodatečný textový prompt poskytnutý pro vedení procesu texturování během fáze refine.

Zastaralé; místo toho čtěte geometry_resolution.

Úroveň Ultra, ve které úkol preview proběhl (2k nebo 4k); u standard je vynecháno.

Stažitelná URL adresa obrázku textury, který byl použit k vedení procesu texturování.

Stažitelná URL adresa miniatury souboru modelu.

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

Stažitelná URL adresa náhledového videa. V budoucí verzi bude odstraněno.

Postup úkolu (progress). Pokud úkol ještě nebyl spuštěn, tato vlastnost bude 0. Jakmile úkol uspěje, hodnota se změní na 100.

Časové razítko okamžiku, kdy byl úkol spuštěn, v milisekundách. Pokud úkol ještě nebyl spuštěn, tato vlastnost bude 0.

Časové razítko okamžiku, kdy byl úkol vytvořen, v milisekundách.

Časové razítko okamžiku, kdy byl úkol dokončen, 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 daným úkolem. Obvykle 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ů. Úplný popis objektu task_error naleznete v části Chyby.

Počet kreditů spotřebovaných tímto úkolem. Přítomno, pokud je stav úkolu PENDING, IN_PROGRESS nebo SUCCEEDED. U úkolů se stavem FAILED vrací 0 (kredity jsou při selhání vráceny).