Remesh API

ID dokončené úlohy Obrázek na 3D nebo Text na 3D, kterou chcete remeshovat. Tato úloha musí být jednou z následujících: Text na 3D Preview, Text na 3D Refine, Obrázek na 3D nebo Retexturování. Kromě toho musí mít stav SUCCEEDED.

Poskytněte 3D model, který má Meshy remeshovat, prostřednictvím veřejně přístupné URL adresy nebo data URI. Podporované formáty: .glb, .gltf, .obj, .fbx, .stl.

Pro Data URI použijte MIME type: application/octet-stream.

Maximální velikost souboru: 400 MB pro http nebo https URL, 100 MB pro data: URI.

Soubor GLB, glTF, FBX nebo OBJ nad 100 MB může mít nejvýše 10 000 000 ploch. Plochy se počítají jako trojúhelníky: čtyřúhelník se počítá jako 2 a síť vykreslená vícekrát se počítá jednou za každou kopii. Nad 100 MB musí být soubor FBX binární FBX 7.1 nebo novější a soubor GLB nebo glTF nesmí používat kompresi Draco.

Seznam cílových formátů pro remeshovaný model. Pokud není uveden, vygeneruje se pouze GLB.

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

Určuje topology vygenerovaného modelu.

Dostupné hodnoty:

• quad: Vygeneruje síť s převahou čtyřúhelníků.
• triangle: Vygeneruje decimovanou trojúhelníkovou síť.

Určuje cílový počet polygonů ve vygenerovaném modelu. Skutečný počet polygonů se může od cíle lišit v závislosti na složitosti geometrie.

Platný rozsah je 100 až 300 000 (včetně).

Povolí adaptivní decimaci nastavením úrovně počtu polygonů. Je-li nastaveno, parametr target_polycount se ignoruje.

Dostupné hodnoty:

• 1: Adaptivní — ultra počet polygonů.
• 2: Adaptivní — vysoký počet polygonů.
• 3: Adaptivní — střední počet polygonů.
• 4: Adaptivní — nízký počet polygonů.

Změní velikost modelu na určitou výšku měřenou v metrech. Doporučujeme místo toho použít vyhrazené Resize API.

Změní velikost modelu tak, aby nejdelší rozměr ohraničujícího rámečku odpovídal zadané hodnotě v metrech. Doporučujeme místo toho použít vyhrazené Resize API.

Je-li nastaveno na true, služba použije AI vidění k automatickému odhadu reálné výšky objektu a odpovídajícím způsobem změní velikost modelu. Doporučujeme místo toho použít vyhrazené Resize API.

Je-li true, služba pouze změní formát vstupního souboru modelu a ignoruje ostatní vstupy, jako jsou topology, resize_height a target_polycount. Doporučujeme místo toho použít vyhrazené Convert API.

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.

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

• Chybějící parametr: Musí být zadán buď model_url, nebo input_task_id.
• Neplatná vstupní úloha: input_task_id musí odkazovat na úspěšnou úlohu z podporovaného modelu.
• Neplatný formát modelu: model_url odkazuje na soubor s nepodporovanou příponou.
• Nedostupná URL adresa: model_url se nepodařilo stáhnout.
• Soubor modelu je příliš velký: Soubor model_url přesahuje 400 MB (URL http nebo https) nebo 100 MB (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 jej jako binární FBX nebo GLB.
• Nečitelný soubor modelu: Soubor model_url je větší než 100 MB a jeho hlavičku nelze přečíst, například u GLB nebo glTF komprimovaného pomocí Draco nebo u binárního FBX staršího než 7.1.
• Příliš složitá hlavička modelu: 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 jej znovu.
• Neplatná topology: Parametr topology je neplatný.
• Vzájemně se vylučující parametry: auto_size a resize_height nelze nastavit současně.

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

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

Překročili jste limit rychlosti.

ID úlohy remesh, kterou chcete načíst.

ID úlohy remesh, 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: Řazení podle času vytvoření vzestupně.
• -created_at: Řazení podle času vytvoření sestupně.

Jedinečný identifikátor úlohy Remesh, kterou chcete streamovat.

Jedinečný identifikátor úkolu. Ačkoliv jako implementační detail používáme pro id úkolů k-sortovatelné UUID, neměli byste činit žádné předpoklady o formátu id.

Typ úkolu Remesh. Hodnota je remesh.

Stažitelná URL adresa k texturovanému souboru 3D modelu vygenerovanému 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.

Stažitelná URL adresa k náhledovému obrázku vykreslenému z přegenerovaného (remesh) modelu.

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

Průběh úkolu. Pokud úkol ještě nebyl zahájen, tato vlastnost bude 0. Jakmile úkol uspěje, stane se 100.

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

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

Časové razítko vytvoření úkolu, v milisekundách.

Časové razítko zahájení úkolu, v milisekundách. Pokud úkol ještě nebyl zahájen, tato vlastnost bude 0.

Časové razítko dokončení úkolu, v milisekundách. Pokud úkol ještě nebyl dokončen, tato vlastnost bude 0.

Podrobnosti chyby pro neúspěšné úkoly. Úplný popis objektu task_error najdete v části Chyby.

Počet kreditů spotřebovaných tímto úkolem. Přítomno, pokud je stav úkolu PENDING, IN_PROGRESS nebo SUCCEEDED. Pro úkoly se stavem FAILED vrací 0 (kredity jsou v případě neúspěchu vráceny).