Auto Split API

ID úspěšné úlohy, jejíž model se má rozdělit. Podporované typy úloh: Obrázek na 3D, Více obrázků na 3D, Text na 3D (náhled), Remesh, Převést a Změnit velikost. Úloha musí mít stav SUCCEEDED a její model musí být vygenerován pomocí Meshy 6 nebo Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1 nebo latest). Modely typu low-poly a Smart Topology (meshy-t2) nejsou podporovány. Model s texturou je přijat, ale jeho textura se do výsledku nepřenáší.

Jak se model rozdělí na díly.

Dostupné hodnoty:

• auto: Meshy zvolí řezy sám. prompt se ignoruje.
• by_parts: Řeže podél strukturálních částí, které pojmenujete v prompt, například hlava, paže a trup.
• by_color: Řeže podél barevných oblastí, které pojmenujete v prompt. Vyžaduje vstup vygenerovaný z nahraného obrázku (Obrázek na 3D nebo Více obrázků na 3D); jiné vstupy jsou odmítnuty s kódem 400. Hranice barevných oblastí pocházejí ze zdrojového obrázku, nikoli z textury vstupního modelu. U funkce Více obrázků na 3D používá Auto Split první zdrojový obrázek.

Formáty, ve kterých se má rozdělený model exportovat. Formáty podporující objekty scény (glb, obj, fbx, usdz, blend, 3mf) uchovávají každý díl jako samostatný objekt; stl nemá koncept samostatných objektů, takže spojí všechny díly do jednoho pevného tělesa uspořádaného podle layout (pokud chcete samostatně vybíratelné díly ve slicer, vyžádejte si 3mf). glb je vždy vytvořen a vrácen v model_urls; ostatní formáty, které chcete navíc, uveďte v seznamu.

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

Jak jsou díly uspořádány ve všech výstupních formátech a v miniatuře.

Dostupné hodnoty:

• assembled: Díly zůstávají tam, kde je měl zdrojový model.
• on_plate: Díly jsou rozloženy naplocho a rozprostřeny na tiskové podložce, připravené ke slicování — stejné uspořádání jako v pohledu On Plate ve webové aplikaci.

V obou uspořádáních je před exportem odstraněn zborcený úlomek nebo bodu podobný kousek zbylý po řezu, takže každý získaný díl je tisknutelný. Formáty podporující objekty scény obsahují jeden objekt na díl; stl je spojí do jednoho pevného tělesa.

Přidá na každý řez spoje typu čep a dlab, aby vytištěné díly do sebe zapadaly.

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

• Chybějící prompt: prompt je vyžadován, pokud je mode nastaven na by_parts nebo by_color.
• Prompt nepopisuje žádné rozdělení, nebo je dílů příliš mnoho: by_parts / by_color přijímá 1 až 10 pojmenovaných dílů. Popis, který žádá o zachování modelu v jednom kuse, nebo pojmenovává více než 10 dílů, je odmítnut. Nic se neúčtuje.
• Nepodporovaná vstupní úloha: input_task_id musí odkazovat na úspěšnou úlohu podporovaného typu, vygenerovanou pomocí Meshy 6 nebo Meshy 7.
• Chybějící referenční obrázek: by_color vyžaduje vstup vygenerovaný z nahraného obrázku.
• Spoj mimo rozsah: connector_size nebo connector_height je mimo rozsah 0.1 až 0.8.

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

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

input_task_id neexistuje nebo nepatří k vašemu účtu.

Překročili jste svůj limit rychlosti. Požadavky by_parts a by_color také sdílejí limit zpracování promptů ve výši 12 požadavků za minutu na účet.

Rozdělování na základě promptu (by_parts a by_color) je dočasně nedostupné. Zkuste to znovu později, nebo použijte mode: "auto", které tím není ovlivněno. Nic se neúčtuje.

ID úlohy Auto Split, kterou chcete načíst.

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

Číslo stránky pro stránkování. Začíná a výchozí hodnota je 1.

Limit velikosti stránky. Výchozí hodnota je 10 položek. Maximální povolená hodnota je 100 položek; vyšší hodnoty jsou omezeny na 100.

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 Auto Split, kterou chcete streamovat.

Unikátní identifikátor úlohy. Ačkoli 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. Hodnota je print-split.

Stažitelné URL k rozdělenému modelu, jedno pro každý požadovaný formát. Formáty podporující objekty scény zachovávají každou část jako samostatný objekt; stl je sloučí do jednoho pevného tělesa. Vlastnost pro daný formát bude vynechána, pokud tento formát nebyl vyžádán.

Stažitelné URL na vykreslený náhled rozděleného modelu, kde má každá část odlišnou barvu, v požadovaném layout.

true, pokud prompt požadavku by_parts nebo by_color nepojmenoval žádné části, a Meshy proto model rozdělil automaticky — názvy částí ve výsledku pak pocházejí od Meshy, ne od vás. Přítomno od PENDING dál. Vynecháno u úloh auto a vždy, když byl prompt dodržen.

Počet tisknutelných částí, které rozdělení vytvořilo. Formáty podporující objekty scény obsahují jeden objekt na část; stl je sloučí do jednoho pevného tělesa, ale počet stále odpovídá počtu částí. Zhroucené útržky, které segmentace nedokázala převést na tisknutelnou část, jsou před exportem ze souborů odstraněny a nejsou počítány.

Postup úlohy. Pokud úloha ještě nebyla zahájena, bude tato vlastnost 0. Jakmile úloha úspěšně skončí, změní se na 100.

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

Počet předchozích úloh.

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

Časové razítko zahájení úlohy, v milisekundách. Pokud úloha ještě nebyla zahájena, bude tato vlastnost 0.

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

Podrobnosti o chybě u neúspěšných úloh. Úplný popis objektu task_error naleznete v Chyby.

Počet kreditů spotřebovaných touto úlohou. Vždy přítomno: 10 po přijetí úlohy a 0 u úloh FAILED, protože poplatek je při neúspěchu vrácen. Odstranění úlohy, dokud je stále PENDING, ji rovněž vrátí.