Text na 3D API

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

Popište, jaký druh objektu 3D model představuje. Maximálně 600 znaků.

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

Dostupné hodnoty:

• standard: Běžné generování 3D sítě s vysokými detaily.
• lowpoly: Generuje low-poly síť optimalizovanou pro čistší polygony.

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

Určuje, zda povolit fázi Remesh. Když je nastaveno na false, API přímo vrátí trojúhelníkovou síť s nejvyšší přesností.

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čete pose_mode pro vygenerovaný model.

Dostupné hodnoty:

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

Místo toho použijte pose_mode. Zda vygenerovat model v A/T pose.

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

Když je nastaveno na true, vstupní obsah bude automaticky zkontrolován na potenciálně škodlivý obsah. Pokud je škodlivý obsah detekován, úloha nepřejde ke generování.

Text z prompt bude zkontrolován.

Určuje, které formáty 3D souborů zahrnout 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, zahrnou se všechny podporované formáty.

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

Když 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.

Když je nastaveno na true, služba použije AI vision k automatickému odhadu skutečné výšky objektu a odpovídajícímu změnění velikosti modelu. Počátek bude ve výchozím nastavení bottom, pokud není origin_at výslovně nastaveno.

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

• Chybějící parametr: Chybí požadovaný parametr (např. prompt, mode).
• Neplatný parametr: art_style není jednou z povolených hodnot.
• Příliš dlouhý prompt: prompt překračuje limit znaků.

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 by mělo být při vytváření úlohy refine nastaveno na "refine".

ID odpovídající náhledové úlohy.

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

Kromě základní barvy vygeneruje PBR mapy (metallic, roughness, normal). Mapa emisí je také zahrnuta, když je ai_model nastaven na meshy-6 nebo latest.

Vygeneruje texturu základní barvy v rozlišení 4K (4096×4096) pro vyšší úroveň detailů.

Zadejte dodatečný textový prompt pro vedení procesu texturování. Maximálně 600 znaků.

Zadejte 2D obrázek pro vedení procesu texturování. Aktuálně podporujeme formáty .jpg, .jpeg a .png.

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

• Veřejně přístupná URL: URL, která je přístupná z veřejného internetu
• Data URI: Data URI obrázku kódovaná v base64. Příklad Data URI: data:image/jpeg;base64,<your base64-encoded image data>

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

Při nastavení na true bude vstupní obsah automaticky kontrolován na potenciálně škodlivý obsah. Pokud je zjištěn škodlivý obsah, úloha nebude pokračovat ke generování.

Bude kontrolován jak text z texture_prompt, tak obrázek z texture_image_url.

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

Určuje, které formáty 3D souborů mají být zahrnuty ve výstupu. Vygenerují a vrátí se pouze požadované formáty, což může zkrátit dobu dokončení úlohy. Pokud je vynecháno, zahrnou se všechny podporované formáty.

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

Při nastavení 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.

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

Požadavek nebyl př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 modelu: AI model náhledové úlohy není kompatibilní s požadovaným modelem refine.

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

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

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

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

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

ID úlohy Text na 3D, která se má odstranit.

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

Limit velikosti stránky. Maximum povolených položek je 50.

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, která se má streamovat.

Jedinečný identifikátor úlohy. Přestože jako implementační detail používáme pro ID úloh k-sortable UUID, 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 zpřesnění.

URL ke stažení souboru otexturovaného 3D modelu vygenerovaného službou Meshy. Vlastnost pro daný formát bude vynechána, pokud formát není vygenerován, namísto vrácení prázdného řetězce.

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

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

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

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

Dodatečný textový prompt poskytnutý k vedení procesu texturování během fáze zpřesnění.

URL ke stažení obrázku textury, který byl použit k vedení procesu texturování.

URL ke stažení obrázku miniatury souboru modelu.

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

URL ke stažení videa náhledu. Bude odstraněno v budoucí verzi.

Progress úlohy. Pokud úloha ještě nebyla spuštěna, tato vlastnost bude 0. Jakmile bude úloha úspěšně dokončena, hodnota bude 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ě není dokončena, tato vlastnost bude 0.

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

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

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

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

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).