Multi-Color Print API

ID úspěšně dokončené úlohy, která se použije jako vstup. Podporované typy úloh: Obrázek na 3D, Více obrázků na 3D, Text na 3D, Remesh a Retexturování. Úloha musí mít stav SUCCEEDED.

Veřejně dostupná URL adresa modelu .glb nebo .fbx, nebo base64 data: URL adresa souboru GLB (data:model/gltf-binary;base64,...). Soubor .fbx musí být odeslán jako URL adresa http nebo https.

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

Soubor nad 100 MB může mít nejvýše 8 000 000 plošek. Plošky 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 verze 7.1 nebo novější a soubor GLB nesmí používat kompresi Draco.

Maximální počet barev ve výsledné paletě.

Platný rozsah: 1 až 16.

Vizuální barevný styl generovaného souboru 3MF.

Dostupné hodnoty:

• realistic: Barvy vzorkuje přímo z textury modelu pro jemné, fotorealistické detaily. Vytváří větší soubor.
• cartoon: Zploští barvy do čistých, jednotných oblastí pro stylizovaný vzhled. Vytváří menší soubor.

Vstup musí obsahovat barvu: realistic vyžaduje jednu základní barevnou texturu s UV souřadnicemi na každé části sítě; cartoon přijímá i barvy jednotlivých vrcholů. Netexturované (bílé) modely jsou odmítnuty — viz model_missing_texture.

Hloubka subdivize použitá ke vzorkování barev textury na síť. Vyšší hodnoty zachytí jemnější barevné detaily za cenu většího souboru. Platí pouze pro styl realistic; u cartoon je ignorováno.

Platný rozsah: 3 až 6.

Značka tiskárny, jejíž předvolba slicer je zapsána do souboru 3MF, takže se soubor otevře ve slicer dané značky s odpovídající tiskárnou, filamentem a profilem procesu. Každá značka používá svou výchozí tiskárnu s tryskou 0,4 mm.

Dostupné hodnoty: bambu, anycubic, creality, elegoo, flashforge, prusa, qidi, snapmaker, ankermake.

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ý formát modelu: model_url odkazuje na soubor s nepodporovanou příponou (podporovány jsou pouze .glb a .fbx).
• Nedostupná URL adresa: Soubor model_url se nepodařilo stáhnout.
• Soubor modelu je příliš velký: Soubor model_url přesahuje 400 MB (URL adresa http nebo https) nebo 100 MB (data: URI).
• Příliš mnoho plošek: Soubor model_url je větší než 100 MB a má více než 8 000 000 plošek. Snižte počet plošek 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 komprimovaného pomocí Draco nebo binárního FBX staršího než 7.1.
• Příliš komplexní 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á vstupní úloha: input_task_id musí odkazovat na úspěšně dokončenou úlohu.
• Neplatné max_colors: Hodnota musí být mezi 1 a 16.
• Neplatný style: Hodnota musí být realistic nebo cartoon.
• Neplatné max_depth: Hodnota musí být mezi 3 a 6.
• Neplatné printer_brand: Hodnota musí být jednou z výše uvedených značek.
• Chybí zdroj barvy: Vstupní model nemá žádnou základní barevnou texturu (realistic vyžaduje jednu, s UV souřadnicemi, na každé části sítě) ani barvy vrcholů (cartoon přijímá obojí). Nejprve model otexturujte, nebo pro modely s barvami vrcholů použijte cartoon. Nahrání souborů .fbx je kontrolováno až poté, co je úloha normalizuje, a selže s chybou model_missing_texture místo toho.

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

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

Překročili jste limit rychlosti.

ID úlohy 3D tisku, kterou chcete načíst.

ID úlohy vícebarevného 3D tisku, 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.

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 vícebarevného 3D tisku, kterou chcete streamovat.

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

Typ úlohy 3D tisku. Hodnota je print-multi-color.

Stažitelná URL adresa souboru 3D modelu vygenerovaného Meshy. Vlastnost pro daný formát bude vynechána, pokud daný formát nebyl vygenerován, namísto vrácení prázdného řetězce.

Progress úlohy. Pokud úloha ještě nebyla zahájena, tato vlastnost bude 0. Jakmile úloha uspěje, bude mít hodnotu 100.

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

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ě pro neúspěšné úlohy. Úplnou referenci objektu task_error najdete v části Chyby.

Počet kreditů spotřebovaných touto úlohou. Je přítomno, pokud je stav úlohy PENDING, IN_PROGRESS nebo SUCCEEDED. Pro úlohy se stavem FAILED vrací 0 (v případě selhání jsou kredity vráceny).