Auto Split API

ID:t för en lyckad uppgift vars modell ska delas upp. Uppgiftstyper som stöds: Bild till 3D, Flera bilder till 3D, Text till 3D (förhandsgranskning), Remesh, Konvertera, och Ändra storlek. Uppgiften måste ha status SUCCEEDED, och dess modell måste vara genererad med Meshy 6 eller Meshy 7 (ai_model meshy-6, meshy-7, meshy-7.1, eller latest). Low-poly- och Smart Topology-modeller (meshy-t2, meshy-t2.5) stöds inte. En texturerad modell accepteras, men dess textur förs inte över till resultatet.

Hur modellen delas upp i delar.

Tillgängliga värden:

• auto: Meshy väljer skärningarna. prompt ignoreras.
• by_parts: Skär längs de strukturella delar du namnger i prompt, såsom huvud, armar och torso.
• by_color: Skär längs de färgregioner du namnger i prompt. Kräver en indata som genererats från en uppladdad bild (Bild till 3D eller Flera bilder till 3D); andra indata avvisas med 400. Gränserna för färgregionerna kommer från källbilden, inte från indatamodellens textur. För Flera bilder till 3D använder Auto Split den första källbilden.

Format att exportera den uppdelade modellen i. Format som stöder scenobjekt (glb, obj, fbx, usdz, blend, 3mf) bär varje del som ett separat objekt; stl har inget begrepp om separata objekt, så den sammanfogar varje del till en enda solid arrangerad enligt layout (begär 3mf för separat valbara delar i en slicer). glb produceras alltid och returneras i model_urls; lista eventuella andra format du vill ha utöver detta.

Tillgängliga värden: glb, obj, fbx, stl, usdz, blend, 3mf.

Hur delarna arrangeras i varje utdataformat, och i miniatyrbilden.

Tillgängliga värden:

• assembled: Delarna förblir där källmodellen hade dem.
• on_plate: Delarna läggs platt och sprids ut på byggplattan, redo att skiva — samma arrangemang som webbappens On Plate-vy.

I båda layouterna tas en kollapsad flisa eller punktliknande bit som blivit kvar efter en skärning bort före export, så varje del du får är utskrivbar. Format som stöder scenobjekt håller ett objekt per del; stl sammanfogar dem till en enda solid.

Lägger till tapp-och-hål-kopplingar vid varje skärning så att de utskrivna delarna passar ihop.

Förfrågan kunde inte accepteras. Vanliga orsaker:

• Saknad prompt: prompt krävs när mode är by_parts eller by_color.
• Prompten beskriver ingen uppdelning, eller för många delar: by_parts / by_color accepterar 1 till 10 namngivna delar. En beskrivning som ber om att behålla modellen i ett stycke, eller namnger fler än 10 delar, avvisas. Inget debiteras.
• Uppgiftstyp som inte stöds: input_task_id måste referera till en lyckad uppgift av en typ som stöds, genererad med Meshy 6 eller Meshy 7.
• Ingen referensbild: by_color kräver en indata som genererats från en uppladdad bild.
• Koppling utanför intervallet: connector_size eller connector_height ligger utanför 0.1 till 0.8.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

input_task_id existerar inte eller tillhör inte ditt konto.

Du har överskridit din hastighetsgräns. Förfrågningar med by_parts och by_color delar också en gräns för prompt-tolkning på 12 förfrågningar per minut per konto.

Promptbaserad uppdelning (by_parts och by_color) är tillfälligt otillgänglig. Försök igen senare, eller använd mode: "auto", som inte påverkas. Inget debiteras.

ID:t för den Auto Split-uppgift som ska hämtas.

ID:t för den Auto Split-uppgift som ska raderas.

Sidnummer för paginering. Börjar på och har standardvärdet 1.

Gräns för sidstorlek. Standardvärdet är 10 objekt. Maximalt tillåtet är 100 objekt; större värden begränsas till 100.

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 Auto Split-uppgift som ska strömmas.

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

Uppgiftens typ. Värdet är print-split.

Nedladdningsbara URL:er till den delade modellen, en per begärt format. Format som stöder scenobjekt behåller varje del som ett separat objekt; stl sammanfogar dem till en enda solid. Egenskapen för ett format utelämnas om formatet inte begärdes.

Nedladdningsbar URL till en renderad förhandsgranskning av den delade modellen, med varje del i en egen färg, i den begärda layout.

true när en by_parts- eller by_color-förfrågans prompt inte angav några delar, så att Meshy delade modellen automatiskt istället — delnamnen i resultatet är Meshys, inte dina. Finns med från och med PENDING. Utelämnas för auto-uppgifter och när prompten följdes.

Antal utskrivbara delar som delningen gav. Format som stöder scenobjekt har ett objekt per del; stl sammanfogar dem till en enda solid, och antalet redovisar ändå delarna. Kollapsade flisor som segmenteringen inte kunde omvandla till en utskrivbar del tas bort från filerna före export och räknas inte med.

Uppgiftens progress. Om uppgiften inte har startat ännu 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, CANCELED.

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 ännu kommer denna egenskap att vara 0.

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

Felinformation för misslyckade uppgifter. Se Fel för den fullständiga referensen för task_error-objektet. Om modellens leverantörs säkerhetskontroll avvisar indatamodellen misslyckas uppgiften med task_error.type invalid_input och code provider_content_refused. Se Fel.

Antalet credits som förbrukats av denna uppgift. Finns alltid med: 10 när uppgiften har accepterats, och 0 för FAILED-uppgifter eftersom avgiften återbetalas vid misslyckande. Om en uppgift tas bort medan den fortfarande är PENDING återbetalas den också.