API för flerfärgsutskrift

ID:t för en lyckad uppgift att använda som indata. Uppgiftstyper som stöds: Bild till 3D, Flera bilder till 3D, Text till 3D, Remesh, och Omtexturering. Uppgiften måste ha statusen SUCCEEDED.

Offentligt tillgänglig URL till en .glb- eller .fbx-modell, eller en base64 data:-URL för en GLB (data:model/gltf-binary;base64,...). En .fbx måste skickas som en http- eller https-URL.

Maximal filstorlek: 400 MB för en http- eller https-URL, 100 MB för en data:-URI.

En fil över 100 MB kan ha som mest 8 000 000 polygoner. Polygoner räknas som trianglar: en quad räknas som 2, och ett nät som ritas mer än en gång räknas en gång per kopia. Över 100 MB måste en FBX-fil vara binär FBX 7.1 eller nyare, och en GLB-fil får inte använda Draco-komprimering.

Maximalt antal färger i utdatapaletten.

Giltigt intervall: 1 till 16.

Visuell färgstil för den genererade 3MF-filen.

Tillgängliga värden:

• realistic: Samplar färger direkt från modellens textur för fina, fotorealistiska detaljer. Ger en större fil.
• cartoon: Platta till färger i rena, enhetliga regioner för ett stiliserat utseende. Ger en mindre fil.

Indatan måste innehålla färg: realistic kräver en enda bastextur med UV-koordinater på varje nätdel; cartoon accepterar även färger per vertex. Otexturerade (vita) modeller avvisas — se model_missing_texture.

Uppdelningsdjup som används för att sampla texturfärger på nätet. Högre värden fångar finare färgdetaljer till priset av en större fil. Gäller endast för stilen realistic; ignoreras för cartoon.

Giltigt intervall: 3 till 6.

Skrivarmärke vars slicer-förinställning skrivs in i 3MF-filen, så att filen öppnas i det märkets slicer med en matchande skrivare, filament och processprofil. Varje märke använder sin standardskrivare med ett munstycke på 0,4 mm.

Tillgängliga värden: bambu, anycubic, creality, elegoo, flashforge, prusa, qidi, snapmaker, ankermake.

Begäran kunde inte accepteras. Vanliga orsaker:

• Saknad parameter: Antingen model_url eller input_task_id måste anges.
• Ogiltigt modellformat: model_url pekar på en fil med ett filtillägg som inte stöds (endast .glb och .fbx stöds).
• Onåbar URL: model_url kunde inte laddas ner.
• Modellfilen är för stor: model_url-filen överskrider 400 MB (http- eller https-URL) eller 100 MB (data:-URI).
• För många polygoner: model_url-filen är över 100 MB och har fler än 8 000 000 polygoner. Minska antalet polygoner och skicka sedan filen igen.
• ASCII-FBX över 100 MB: model_url-filen är en ASCII-FBX över 100 MB. Skicka den som binär FBX eller GLB.
• Oläsbar modellfil: model_url-filen är över 100 MB och dess header kan inte läsas, till exempel en Draco-komprimerad GLB, eller en binär FBX äldre än 7.1.
• Modellhuvudet är för komplext: model_url-filen är över 100 MB och dess header har för många nät, noder eller poster att kontrollera. Minska antalet objekt i filen och skicka den sedan igen.
• Ogiltig indatauppgift: input_task_id måste hänvisa till en lyckad uppgift.
• Ogiltigt max_colors: Värdet måste vara mellan 1 och 16.
• Ogiltig style: Värdet måste vara realistic eller cartoon.
• Ogiltigt max_depth: Värdet måste vara mellan 3 och 6.
• Ogiltigt printer_brand: Värdet måste vara ett av märkena som listas ovan.
• Ingen färgkälla: Indatamodellen saknar bastextur (realistic kräver en enda, med UV:er, på varje nätdel) och har inga vertexfärger (cartoon accepterar endera). Texturera modellen först, eller använd cartoon för vertexfärgade modeller. .fbx-uppladdningar kontrolleras efter att uppgiften normaliserat dem och misslyckas med model_missing_texture istället.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

Otillräckligt med credits för att utföra denna uppgift.

Du har överskridit din hastighetsgräns.

ID:t för den 3D-utskriftsuppgift som ska hämtas.

ID:t för den flerfärgade 3D-utskriftsuppgift som ska tas bort.

Sidnummer för paginering. Börjar på och har som standard 1.

Gräns för sidstorlek. Standard är 10 objekt. Maximalt tillåtet är 100 objekt.

Fält att sortera efter. Tillgängliga värden:

• +created_at: Sortera efter skapandetid i stigande ordning.
• -created_at: Sortera efter skapandetid i fallande ordning.

Unik identifierare för den flerfärgade 3D-utskriftsuppgift som ska strömmas.

Unik identifierare för uppgiften. Även om vi använder en k-sorterbar UUID för uppgifts-id som implementationsdetalj bör du inte göra några antaganden om id:ts format.

Typ av 3D-utskriftsuppgift. Värdet är print-multi-color.

Nedladdningsbar URL till 3D-modellfilen som genererats av Meshy. Egenskapen för ett format utelämnas om formatet inte har genererats, istället för att returnera en tom sträng.

Uppgiftens progress. Om uppgiften inte har startat än kommer denna egenskap att vara 0. När uppgiften har lyckats blir den 100.

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Antalet föregående uppgifter.

Tidsstämpel för när uppgiften skapades, i millisekunder.

Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startat än kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften inte har avslutats än kommer denna egenskap att vara 0.

Felinformation för misslyckade uppgifter. Se Fel för den fullständiga referensen för task_error-objektet.

Antalet credits som förbrukats av denna uppgift. Finns med när uppgiftens status är PENDING, IN_PROGRESS, eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).