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 nebo latest). Modely typu low-poly a Smart Topology (meshy-t2) nejsou podporovány.

Způsob, jakým je model rozdělen na díly.

Dostupné hodnoty:

• auto: Meshy zvolí řezy sám. prompt se ignoruje.
• by_parts: Rozřeže model podle strukturálních částí, které pojmenujete v prompt, například hlava, ruce a trup.
• by_color: Rozřeže model podle 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 chybou 400.

Formáty, ve kterých se má rozdělený model exportovat. Každý díl je samostatným objektem v každém formátu. glb se generuje vždy a je vrácen v model_urls; uveďte navíc jakékoli další formáty, které chcete.

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

Jak jsou díly uspořádány v každém výstupním formátu a na miniatuře.

Dostupné hodnoty:

• assembled: Díly zůstávají tam, kde byly ve zdrojovém modelu.
• on_plate: Díly jsou položeny naplocho a rozmístěny na tiskové podložce, připravené k plátkování – stejné uspořádání jako zobrazení On Plate ve webové aplikaci.

V obou uspořádáních exportované soubory obsahují jeden objekt na díl a nic jiného: zborcený tenký zbytek nebo bodový útvar zanechaný po řezu je před exportem odstraněn, takže každý objekt v souboru je tisknutelný.

Přidá spojovací prvky typu čep a drážka na každém řezu, 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 pojmenovává méně než dva díly: by_parts / by_color vyžaduje alespoň dva pojmenované díly (například head, torso, base); obecná instrukce jako split into individual parts je odmítnuta. 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.
• Texturovaný vstup: Vstupní model má textury. Zatím jsou podporovány pouze netexturované modely.
• Chybí referenční obrázek: by_color vyžaduje vstup vygenerovaný z nahraného obrázku.
• Nepodporovaný formát: target_formats obsahuje stl.
• 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 limit rychlosti. Požadavky by_parts a by_color navíc sdílejí limit zpracování promptu ve výši 12 požadavků za minutu na jeden úč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 to 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í 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: Seřadit podle času vytvoření vzestupně.
• -created_at: Seřadit 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 adresy rozděleného modelu, jedna pro každý požadovaný formát. Každá část je v souboru samostatným objektem. Vlastnost pro daný formát bude vynechána, pokud daný formát nebyl vyžádá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 v požadavku by_parts nebo by_color nepojmenoval žádné části, a Meshy tedy model rozdělil automaticky — názvy částí ve výsledku pak pocházejí od Meshy, nikoli od vás. Přítomno od PENDING výše. Vynecháno u úloh auto a kdykoli byl prompt dodržen.

Počet tisknutelných částí v rozděleném modelu — jedna na objekt v exportovaných souborech. Zkolabované úlomky, které segmentace nedokázala převést na tisknutelný díl, jsou před exportem ze souborů odstraněny a nezapočítávají se.

Postup úlohy. Pokud úloha ještě nebyla spuštěna, bude tato vlastnost 0. Jakmile úloha uspěje, hodnota se stane 100.

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

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

Časové razítko okamžiku, kdy byla úloha vytvořena, v milisekundách.

Časové razítko okamžiku, kdy byla úloha spuštěna, v milisekundách. Pokud úloha ještě nebyla spuštěna, bude tato vlastnost 0.

Časové razítko okamžiku, kdy byla úloha dokončena, v milisekundách. Pokud úloha ještě není dokončena, bude tato vlastnost 0.

Podrobnosti chyby 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 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í.