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í detailu.
• smart-topology: Vyberte 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-5, meshy-6, meshy-7, latest (Meshy 7)

Generování 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.

Zapíná generování Ultra pro geometrii s vyšší věrností a jemnějším povrchovým detailem. Generování trvá déle a přidává 5 kreditů.

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íť projde remeshem (decimací) na přibližně tento počet. Rozsah 100 až 300 000, výchozí hodnota 30 000. Je-li nastaven decimation_mode, má přednost a target_polycount se ignoruje.
• Smart Topology — s model_type: smart-topology a ai_model: meshy-t2. Model se generuje přímo s tímto počtem ploch; remesh se nespouští a should_remesh není vyžadován. 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: Vypne symetrii.
• auto: Automaticky určí a použije symetrii na základě vstupní geometrie.
• on: Vynutí symetrii během generování.

Určuje mode pózy pro vygenerovaný 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í póza.

Použijte místo toho pose_mode. 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ěřen 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 je vynechá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 vision 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ů.

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

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

Překročili jste limit rychlosti.

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

Odpovídající id náhledové úlohy.

Stav dané náhledové úlohy musí být SUCCEEDED.

Vygeneruje PBR mapy (metallic, roughness, normal) navíc k základní barvě (base color). Emisní mapa (emission map) je zahrnuta také v případě, že ai_model je meshy-6, s výjimkou texture_resolution: 8k (v tomto případě se emisní mapa nevytváří). meshy-7 (a latest) emisní mapu nevytváří.

Rozlišení textury základní barvy (base color). Jedno z 2k (2048×2048), 4k (4096×4096) nebo 8k (8192×8192). Vyšší rozlišení zachytí více povrchových detailů. Platí pouze pro mode refine.

Použijte místo toho texture_resolution — ekvivalent texture_resolution: "4k". Pokud jsou nastaveny obě hodnoty, má texture_resolution přednost.

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í. Aktuálně podporujeme formáty .jpg, .jpeg a .png.

Existují dva způsoby, jak obrázek zadat:

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

ID modelu, který se má použít pro refine. Dostupné hodnoty: meshy-5, meshy-6, meshy-7, latest (Meshy 7).

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 generování.

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

Odstraní zvýraznění a stíny z textury základní barvy (base color), čí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 čas dokončení úlohy. Pokud je parametr vynechá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 transparentním pozadím (RGBA) a vrátí ji v odpovědi GET jako alpha_thumbnail_url. Stávající pole thumbnail_url se nemění.

Pokud je nastaveno na true, služba pomocí AI vision automaticky odhadne skutečnou výšku objektu ve světě a odpovídajícím způsobem změní velikost modelu. Počátek (origin) bude výchozí bottom, pokud nebude explicitně nastaven origin_at.

Požadavek byl nepřijatelný. Běžné příčiny:

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

Autentizace se nezdařila. Zkontrolujte prosím svůj API klíč.

Nedostatečný počet kreditů k provedení této úlohy.

Náhledová úloha určená parametrem preview_task_id nebyla nalezena.

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

Jedinečný identifikátor pro úkol Text na 3D, který chcete načíst.

ID úlohy Text na 3D ke smazání.

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

Limit velikosti stránky. Maximální povolený počet je 50 položek.

Pole pro třídění.

Dostupné hodnoty:

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

Unikátní identifikátor pro úlohu Text na 3D ke streamování.

Unikátní identifikátor pro úlohu. I když používáme k-tříditelné UUID pro id úloh jako implementační detail, neměli byste dělat žádné předpoklady o formátu id.

Typ úlohy Text na 3D. Možné hodnoty jsou text-to-3d-preview pro úlohy fáze náhledu a text-to-3d-refine pro úlohy fáze vylepšení.

Stahovatelná URL adresa k souboru texturovaného 3D modelu generovaného Meshy. Vlastnost pro formát bude vynechána, pokud formát není generován, místo vrácení prázdného řetězce.

Toto je nemodifikovaný prompt, který byl použit k vytvoření úlohy.

Udržováno pro zpětnou kompatibilitu. Toto pole nemá žádný funkční dopad na generované modely.

Nemodifikovaný art_style, který byl použit k vytvoření úlohy náhledu. Nepodporováno Meshy-6.

Udržováno pro zpětnou kompatibilitu. Toto pole nemá žádný funkční dopad na generované modely.

Další textový prompt poskytnutý k vedení procesu texturování během fáze vylepšení.

Odráží hodnotu ultra_mode, se kterou byla úloha náhledu vytvořena. Přítomna pouze pro úlohy náhledu meshy-7 (nebo latest), které explicitně nastavily ultra_mode; jinak vynecháno.

Stahovatelná URL adresa k texturovému obrázku, který byl použit k vedení procesu texturování.

Stahovatelná URL adresa k miniatuře obrázku souboru modelu.

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

Stahovatelná URL adresa k náhledovému videu. Bude odstraněno v budoucím vydání.

Pokrok úlohy. Pokud úloha ještě nezačala, tato vlastnost bude 0. Jakmile úloha uspěje, stane se 100.

Časové razítko, kdy byla úloha spuštěna, v milisekundách. Pokud úloha ještě nezačala, tato vlastnost bude 0.

Časové razítko, kdy byla úloha vytvořena, v milisekundách.

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

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

Pole objektů URL textur, které jsou generovány z úlohy. Normálně obsahuje pouze jeden objekt URL textury. Každá URL textury má následující vlastnosti:

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

Podrobnosti o chybě pro neúspěšné úlohy. Viz Chyby pro úplnou referenci objektu task_error.

Počet kreditů spotřebovaných touto úlohou. Přítomno, když je stav úlohy PENDING, IN_PROGRESS, nebo SUCCEEDED. Vrací 0 pro úlohy FAILED (kredity jsou při selhání vráceny).