Auto Split API

ID úspěšné úlohy, jejíž model má být rozdělen. 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.

Jak je model rozdělen na části.

Dostupné hodnoty:

• auto: Meshy zvolí řezy sám. prompt je ignorován.
• by_parts: Řez podél strukturálních částí, které pojmenujete v prompt, například hlava, paže a trup.
• by_color: Řez 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); ostatní vstupy jsou odmítnuty s chybou 400.

Formáty, ve kterých se má rozdělený model exportovat. Každá část je v každém formátu samostatným objektem. glb se vytváří vždy a je vrácen v model_urls; ostatní požadované formáty uveďte navíc.

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

3mf je vytvořen pro slicery: jeden objekt na část, každá ve vlastním slotu pro filament, takže Bambu Studio otevře soubor jako jednotlivě obarvené, samostatně vybíratelné části (archiv obsahuje konfiguraci projektu pro Bambu Studio; ostatní slicery načtou pouze geometrii). Stejně jako u ostatních tiskových formátů Meshy je jednotkou milimetr, a jelikož tento koncový bod nepřijímá cílovou velikost, celý model se zmenší tak, aby jeho nejdelší strana měřila 150 mm — stejný limit, jaký používají exporty do ostatních tiskových formátů, zvolený tak, aby se model vešel na většinu běžných tiskových podložek. Při layout: "on_plate" se tento limit vztahuje na celou rozloženou podložku jako celek, takže je soubor připraven ke slicování; při assembled zůstávají části tam, kde je měl zdrojový model, a jejich rozmístění provedete ve slicer.

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

Dostupné hodnoty:

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

V obou uspořádáních obsahují exportované soubory jeden objekt na část a nic navíc: zborcený úzký proužek nebo bodová část zbylá po řezu je před exportem odstraněna, takže každý objekt v souboru je tisknutelný.

Přidá na každém řezu spojovací prvky typu čep a dlab, aby vytištěné díly do sebe zapadaly.

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

• Chybějící prompt: prompt je povinný, pokud je mode nastaven na by_parts nebo by_color.
• Prompt pojmenovává méně než dvě části: by_parts / by_color vyžaduje alespoň dva pojmenované kusy (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 obsahuje textury. Prozatím jsou podporovány pouze netexturované modely.
• Chybějící 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 se nezdařila. Zkontrolujte prosím svůj API klíč.

Nedostatek kreditů pro 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í promptů 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 znovu později, nebo použijte mode: "auto", kterého se tato nedostupnost 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.

Jedinečný 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 tento 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 v požadavku by_parts nebo by_color nepojmenoval žádné části, a Meshy proto model rozdělilo automaticky — názvy částí ve výsledku pak pocházejí od Meshy, ne od vás. Přítomno od stavu PENDING. 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řeměnit na tisknutelný díl, jsou před exportem ze souborů odstraněny a nejsou započítány.

Postup úlohy (progress). Pokud úloha ještě nebyla zahájena, tato vlastnost bude 0. Jakmile úloha uspěje, stane se 100.

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

Počet předcházející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, tato vlastnost bude 0.

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

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

Počet kreditů spotřebovaných touto úlohou. Vždy přítomno: 10 poté, co je úloha přijata, a 0 u úloh se stavem FAILED, protože poplatek je při selhání vrácen. Vrácen je také při smazání úlohy, dokud je stále ve stavu PENDING.