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 status 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, meshy-t2.5) nejsou podporovány. Model s texturou je přijímán, ale jeho textura se do výsledku nepřenáší.

Jak se model rozdělí na části.

Dostupné hodnoty:

• auto: Meshy zvolí řezy sám. prompt je ignorován.
• by_parts: Rozřeže podél strukturálních částí, které uvedete v prompt, například hlava, paže a trup.
• by_color: Rozřeže podél barevných oblastí, které uvedete v prompt. Vyžaduje vstup vygenerovaný z nahraného obrázku (Obrázek na 3D nebo Více obrázků na 3D); ostatní vstupy jsou odmítnuty s chybou 400. Hranice barevných oblastí vychá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 rozdělený model exportuje. Formáty podporující scénové objekty (glb, obj, fbx, usdz, blend, 3mf) nesou každou část jako samostatný objekt; stl pojem samostatných objektů nezná, proto sloučí všechny části do jednoho pevného tělesa uspořádaného podle layout (pro samostatně vybíratelné části ve slicer požadujte 3mf). glb se vytváří vždy a vrací se v model_urls; jakékoli další požadované formáty uveďte navíc.

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

Jak jsou части uspořádány ve všech výstupních formátech a v miniatuře.

Dostupné hodnoty:

• assembled: Části zůstávají tam, kde je měl zdrojový model.
• on_plate: Části jsou položeny naplocho a rozmístěny na tiskové podložce, připravené k nařezání – stejné uspořádání jako zobrazení On Plate ve webové aplikaci.

V obou uspořádáních je před exportem odstraněn zhroucený tenký nebo bodový zbytek po řezu, takže každá získaná část je tisknutelná. Formáty podporující scénové objekty obsahují jeden objekt na část; stl je sloučí do jednoho pevného tělesa.

Přidá na každém řezu pero-drážkové spojovací prvky (mortise-and-tenon), aby do sebe vytištěné části zapadaly.

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

• Chybějící prompt: prompt je povinný, pokud je mode nastaven na by_parts nebo by_color.
• Prompt nežádá žádné rozdělení, nebo žádá příliš mnoho částí: by_parts / by_color přijímá 1 až 10 pojmenovaných dílů. Popis, který žádá zachování modelu v jednom kuse, nebo pojmenovává více než 10 částí, 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.
• Žádný referenční obrázek: by_color vyžaduje vstup vygenerovaný z nahraného obrázku.
• Spojovací prvek mimo rozsah: connector_size nebo connector_height je mimo rozsah 0.1 až 0.8.

Autentizace selhala. 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 navíc 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 prosím později, nebo použijte mode: "auto", kterého se tento problém netýká. Nic se neúčtuje.

ID úlohy Auto Split, kterou chcete získat.

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

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

Limit velikosti stránky. Výchozí hodnota je 10 položek. Maximální povolená hodnota je 100 položek; větší 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, pro kterou se má spustit streamování.

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

Typ úlohy. Hodnota je print-split.

Stažitelné URL adresy rozděleného modelu, jedna pro každý požadovaný formát. Formáty podporující objekty scény uchová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 daný formát nebyl požadován.

Stažitelná URL adresa vykresleného náhledu 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 tak model rozdělilo automaticky — názvy částí ve výsledku jsou od Meshy, nikoli vaše. Přítomno od stavu PENDING dále. Vynecháno pro úlohy 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 každou část; stl je sloučí do jednoho pevného tělesa, přičemž počet stále udává počet částí. Zhroucené zbytky, které segmentace nedokázala přeměnit na tisknutelný díl, jsou před exportem ze souborů odstraněny a nejsou započítány.

Průběh úlohy. Pokud úloha ještě nebyla zahájena, bude tato vlastnost 0. Jakmile úloha uspěje, bude tato hodnota 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ě pro neúspěšné úlohy. Úplný referenční popis objektu task_error naleznete v části Chyby. Pokud bezpečnostní kontrola poskytovatele modelu vstupní model odmítne, úloha selže s task_error.type invalid_input a code provider_content_refused. Viz Chyby.

Počet kreditů spotřebovaných touto úlohou. Vždy přítomno: 10 jakmile je úloha přijata, a 0 u úloh FAILED, protože poplatek je v případě selhání vrácen. Smazání úlohy, dokud je stále ve stavu PENDING, ji rovněž vrátí.