Text na 3D API

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

Popište, o jaký typ 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é, bude vyřazeno 30. října 2026): Generuje low-poly síť optimalizovanou na čistší polygony. Místo toho doporučujeme Meshy T2: smart-topology s meshy-t2.

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í Smart Topology (model_type: smart-topology):

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

Průchod generování geometrie. 2k spustí Ultra průchod v rozlišení 2048³; 4k jej spustí v rozlišení 4096³ pro nejjemnější detail povrchu.

Dostupné hodnoty: standard, 2k, 4k

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

Řídí, zda se má povolit fáze remesh. Pro nejvyšší kvalitu modelu 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 přepočítána (decimována) na přibližně tento počet. Rozsah 100 až 300 000, výchozí hodnota 30 000. Pokud je nastaven 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; neprobíhá žádný remesh 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 aplikuje symetrii na základě vstupní geometrie.
• on: Vynutí symetrii během generování.

Určuje pose mode pro vygenerovaný model.

Dostupné hodnoty:

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

Místo toho použijte pose_mode. Určuje, zda se má model vygenerovat 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.

Pokud je nastaveno na true, vstupní obsah bude automaticky zkontrolován na potenciálně škodlivý obsah. Pokud je škodlivý obsah detekován, úkol nebude pokračovat ke generování.

Kontrolová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í úkolu. Pokud není uvedeno, zahrnou se všechny podporované formáty.

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

Pokud je nastaveno na true, úkol navíc vyrenderuje 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.

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

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ů pro provedení tohoto úkolu.

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

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

Odpovídající ID náhledového úkolu.

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

Vygeneruje PBR mapy (metallic, roughness, normal) nad rámec základní barvy. Pokud je ai_model nastaven na meshy-6, je zahrnuta i emisní mapa, s výjimkou texture_resolution: 8k (emisní mapa se v tomto případě negeneruje). meshy-6-lite, meshy-7.1 a latest emisní mapu negenerují, stejně tak ani refine náhledu meshy-t2, u kterého není nastaven ai_model.

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 detailů povrchu. Platí pouze pro mode refine.

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

Zadejte dodatečný textový prompt, který bude řídit proces texturování. Maximálně 800 znaků.

Poskytněte 2D obrázek, který bude řídit proces texturování. Momentálně 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 adresa: URL adresa přístupná z veřejného internetu
• Data URI: Base64 kódovaná Data URI adresa obrázku. 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-6-lite, meshy-6, meshy-7.1, latest (Meshy 7.1)
• meshy-7 (zastaralé): místo toho použijte meshy-7.1.

Pokud tento parametr vynecháte, zdědí se model použitý v náhledovém úkolu, díky čemuž zůstanou náhled a jeho refine po celou dobu na stejném modelu. Pro přepsání tohoto dědění zadejte explicitní hodnotu.

Pokud je nastaveno na true, vstupní obsah bude automaticky zkontrolován na potenciálně škodlivý obsah. Pokud je škodlivý obsah detekován, úkol nebude pokračovat ke generování.

Kontrolová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 v nastaveních s vlastním osvětlením.

Určuje, které formáty 3D souborů budou zahrnuty do výstupu. Vygenerovány a vráceny budou pouze požadované formáty, což může zkrátit dobu dokončení úkolu. Pokud není zadáno, zahrnou se všechny podporované formáty.

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

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

Pokud je 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 (origin) bude standardně nastaven na bottom, pokud není výslovně nastaven origin_at.

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

• Neplatné ID úkolu: preview_task_id je neplatné nebo neexistuje.
• Úkol není připraven: Náhledový úkol ještě nebyl úspěšně dokončen.
• Nesoulad modelů: AI model náhledového úkolu není kompatibilní s požadovaným modelem pro refine.
• Nepodporovaný model pro remove_lighting: remove_lighting je nastaveno společně s ai_model: "meshy-6-lite".

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

Nedostatek kreditů k provedení tohoto úkolu.

Náhledový úkol zadaný pomocí preview_task_id nebyl nalezen.

Překročili jste limit rychlosti.

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

ID úlohy Text na 3D, kterou chcete smazat.

Čí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 Text na 3D, kterou chcete streamovat.

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

Typ úlohy Text na 3D. Možné hodnoty jsou text-to-3d-preview pro úlohy fáze preview a text-to-3d-refine pro úlohy fáze 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 neupravený prompt, který byl použit k vytvoření úlohy.

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

Neupravený art_style, který byl použit k vytvoření úlohy preview. Není podporováno u Meshy-6.

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

Dodatečný textový prompt poskytnutý k řízení procesu texturování během fáze refine.

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

Úroveň Ultra, se kterou úloha preview proběhla (2k nebo 4k); vynecháno pro standard.

Stažitelná URL adresa obrázku textury, který byl použit k řízení 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 pokud byla úloha vytvořena 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. Bude odstraněno v budoucí verzi.

Postup úlohy. Pokud úloha ještě nebyla spuštěna, tato vlastnost bude 0. Jakmile úloha uspěje, bude mít hodnotu 100.

Časové razítko okamžiku, kdy byla úloha spuštěna, v milisekundách. Pokud úloha ještě nebyla spuštěna, tato vlastnost bude 0.

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

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

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

Pole objektů URL textur vygenerovaných danou úlohou. Běžně 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ě u neúspěšných úloh. Úplný popis objektu task_error najdete v části Chyby.

Počet kreditů spotřebovaných touto úlohou. Přítomno, pokud je stav úlohy PENDING, IN_PROGRESS nebo SUCCEEDED. Pro úlohy se stavem FAILED vrací 0 (v případě selhání jsou kredity vráceny).