Remesh API

Povinné, pokud neodešlete model_url. ID úlohy, jejíž model chcete remeshovat, například úlohy Text na 3D, Obrázek na 3D, Retexturování nebo Remesh. Úloha musí být vytvořena vámi přes API a musí mít stav SUCCEEDED.

Povinné, pokud neodešlete input_task_id. Model k remeshování, jako veřejná URL adresa nebo data URI. Pokud odešlete obojí, Meshy použije input_task_id.

Model musí být soubor GLB, glTF, OBJ, FBX nebo STL o velikosti maximálně 400 MB z URL adresy http nebo https, nebo 100 MB jako data URI. U data URI použijte MIME type application/octet-stream.

Soubor nad 100 MB musí navíc splňovat tato pravidla:

• Soubor GLB, glTF, FBX nebo OBJ může mít maximálně 10 000 000 ploch. Meshy počítá plochy jako trojúhelníky, takže čtyřúhelník se počítá jako 2 a síť vykreslená vícekrát se počítá jednou za každou kopii.
• Soubor FBX musí být binární FBX 7.1 nebo novější.
• Soubor GLB nebo glTF nesmí používat kompresi Draco.

Formáty souborů, které se mají vygenerovat.

Dostupné hodnoty:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Typ ploch remeshovaného modelu.

Dostupné hodnoty:

• quad: síť s převahou čtyřúhelníků
• triangle: decimovaná trojúhelníková síť

Počet ploch, kterého se má dosáhnout, od 100 do 300000. Výsledek se může od cílové hodnoty lišit v závislosti na geometrii modelu. Hodnota mimo rozsah vrátí 400.

Adaptivní počet ploch podle úrovně. Pokud ji nastavíte, Meshy ignoruje target_polycount.

Dostupné hodnoty:

• 1: ultra
• 2: vysoká
• 3: střední
• 4: nízká

Místo toho použijte Resize API. Výška, na kterou se má model změnit, v metrech. Odešlete maximálně jeden z parametrů resize_height, resize_longest_side a auto_size.

Místo toho použijte Resize API. Délka, na kterou se má změnit nejdelší strana ohraničujícího kvádru modelu, v metrech. Odešlete maximálně jeden z parametrů resize_height, resize_longest_side a auto_size.

Místo toho použijte Resize API. Zda odhadnout skutečnou výšku objektu pomocí AI vidění a podle toho model změnit velikost. Odešlete maximálně jeden z parametrů resize_height, resize_longest_side a auto_size.

Místo toho použijte Resize API. Kam umístit počátek modelu, bottom nebo center. Výchozí hodnota se použije, pokud odešlete resize_height, resize_longest_side nebo auto_size. Bez jednoho z nich Meshy přesune počátek, jen pokud odešlete origin_at.

Místo toho použijte Convert API. Zda pouze převést model do formátů target_formats. Pokud je true, Meshy ignoruje topology, target_polycount, decimation_mode, resize_height, resize_longest_side a auto_size, ale přesto kontroluje jejich hodnoty, takže neplatná hodnota vrátí 400. S convert_format_only: true prázdné nebo null target_formats vrátí 400.

Zda vykreslit i náhled s průhledným pozadím (RGBA), vrácený v alpha_thumbnail_url při získání úlohy. thumbnail_url se nezmění.

Požadavek nelze spustit. Chybová zpráva uvádí, jaký problém byl zjištěn. Například:

• Chybějící parametr: Nebyl odeslán ani model_url, ani input_task_id.
• Neplatná vstupní úloha: input_task_id není úspěšná úloha API, nebo její AI model nepodporuje remeshování.
• Neplatný formát modelu: Soubor model_url má nepodporovanou příponu.
• Nedostupná URL adresa: Meshy nemůže stáhnout soubor model_url.
• Soubor modelu je příliš velký: Soubor model_url je větší než 400 MB z URL adresy http nebo https, nebo větší než 100 MB jako data URI.
• Příliš mnoho ploch: Soubor model_url je větší než 100 MB a má více než 10 000 000 ploch. Snižte počet ploch a soubor odešlete znovu.
• ASCII FBX nad 100 MB: Soubor model_url je ASCII FBX větší než 100 MB. Odešlete ho jako binární FBX nebo GLB.
• Nečitelný soubor modelu: Soubor model_url je větší než 100 MB a Meshy nemůže přečíst jeho hlavičku. Jde například o GLB nebo glTF komprimovaný pomocí Draco nebo o binární FBX starší než 7.1.
• Hlavička modelu je příliš složitá: Soubor model_url je větší než 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 ho znovu.
• Neplatná topologie: topology není quad ani triangle.
• Vzájemně se vylučující parametry: Požadavek obsahuje více než jeden z parametrů auto_size, resize_height a resize_longest_side. Odešlete pouze jeden.

Opravte požadavek a odešlete ho znovu. Viz Chyby.

API klíč chybí nebo je neplatný. Zkontrolujte hlavičku Authorization.

Například:

• Nedostatek kreditů: Účet nemá dostatek kreditů pro tuto úlohu, nebo účet dosáhl limitu kreditů. Zkontrolujte svůj zůstatek kreditů a zkuste to znovu.
• Bezplatný plán: Vytvoření úlohy vyžaduje placený plán. Upgradujte svůj plán v nastavení předplatného a zkuste to znovu.

input_task_id je model typu basreliéf, který tento koncový bod nedokáže remeshovat. Zpráva zní This model type does not support this operation. Odešlete jiný model.

input_task_id neodpovídá žádné z vašich úloh. Zkontrolujte ID úlohy a odešlete požadavek znovu.

Překročili jste limit rychlosti. Počkejte a zkuste to znovu. Viz Limity rychlosti.

ID úlohy z odpovědi na vytvoření.

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

Číslo stránky, kterou chcete vrátit, až do 255. Vyšší hodnota vrátí 400.

Počet úloh na stránku, až 100.

Pořadí řazení.

Dostupné hodnoty:

• +created_at: od nejstarších
• -created_at: od nejnovějších

ID úlohy z odpovědi na vytvoření.

ID úkolu. Považujte jej za neprůhledný řetězec a nespoléhejte na jeho formát.

Typ úkolu, vždy remesh.

URL adresy ke stažení remeshovaného modelu, jedna pro každý formát souboru. Formát, který úkol nevygeneroval, nemá klíč, místo prázdného řetězce.

URL adresa ke stažení náhledového obrázku remeshovaného modelu.

URL adresa ke stažení verze thumbnail_url s průhledným pozadím (RGBA). Přítomna pouze tehdy, když jste úkol vytvořili s alpha_thumbnail: true a Meshy vykreslilo průhledný náhled.

Kolik z úkolu je hotovo, v procentech. Je 0, dokud úkol nezačne, a 100, když uspěje.

Stav úkolu, jeden z PENDING, IN_PROGRESS, SUCCEEDED, FAILED nebo CANCELED.

Počet úkolů před tímto úkolem ve frontě. Hodnota má smysl pouze tehdy, když je úkol ve stavu PENDING.

Čas vytvoření úkolu, v milisekundách Unixu.

Čas zahájení úkolu, v milisekundách Unixu. Je 0, dokud úkol nezačne.

Čas dokončení úkolu, v milisekundách Unixu. Je 0, dokud úkol neskončí.

Čas, kdy vyprší platnost URL adres pro stažení úkolu, v milisekundách Unixu. Je 0, dokud úkol neskončí.

URL adresy ke stažení textur modelu, pokud úkol uspěje: pole objektů, jeden pro každou sadu textur. Každý objekt má URL base_color a může mít také URL metallic, roughness, normal, emission a metallic_roughness. Je null, dokud úkol neuspěje, a prázdné pole, když model nemá žádné textury.

Podrobnosti o chybě, když úkol selže. Viz Chyby.

Počet kreditů, které úkol spotřeboval. Přítomno, když je stav PENDING, IN_PROGRESS nebo SUCCEEDED. U úkolu se stavem FAILED je 0, protože Meshy v případě selhání úkolu vrací kredity.