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 ha genererats med Meshy 6 eller Meshy 7 (ai_model meshy-6, meshy-7 eller latest). Low-poly- och Smart Topology-modeller (meshy-t2) stöds inte.

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, till exempel huvud, armar och bål.
• by_color: Skär längs de färgområden 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.

Format att exportera den uppdelade modellen i. Varje del är ett separat objekt i varje format. glb produceras alltid och returneras i model_urls; ange övriga format du också vill ha.

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

3mf skrivs för slicers: ett objekt per del, var och en på sin egen filamentplats, så att Bambu Studio öppnar filen som individuellt färgade, separat valbara delar (arkivet innehåller en Bambu Studio-projektkonfiguration; andra slicers läser geometrin). Liksom Meshys övriga utskriftsformat anges den i millimeter, och eftersom denna endpoint inte tar någon målstorlek, skalas hela modellen så att dess längsta sida blir 150 mm — samma gräns som de andra utskriftsformatens exporter använder, vald för att passa alla vanliga byggplattor. Med layout: "on_plate" gäller gränsen hela den utlagda plattan, så att filen är redo att skäras (slice); med assembled placeras delarna där källmodellen hade dem, och du arrangerar dem själv i slicern.

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 utspridda på byggplattan, redo att skäras (slice) — samma arrangemang som webbappens On Plate-vy.

I båda layouterna innehåller de exporterade filerna ett objekt per del och inget annat: en hopfallen flisa eller punktliknande bit som blir kvar efter en skärning tas bort före export, så att varje objekt du hittar i filen är utskrivbart.

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

Begäran var oacceptabel. Vanliga orsaker:

• Saknad prompt: prompt krävs när mode är by_parts eller by_color.
• Prompt namnger färre än två delar: by_parts / by_color kräver minst två namngivna delar (till exempel head, torso, base); en generisk instruktion som split into individual parts 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.
• Texturerad indata: Indatamodellen har texturer. Endast otexturerade modeller stöds för närvarande.
• Ingen referensbild: by_color kräver en indata som genererats från en uppladdad bild.
• Format som inte stöds: target_formats innehåller stl.
• Koppling utanför intervall: 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 finns inte eller tillhör inte ditt konto.

Du har överskridit din hastighetsgräns. by_parts- och by_color-förfrågningar delar även 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 för den Auto Split-uppgift som ska hämtas.

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

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 formatet på id:t.

Typ av uppgift. Värdet är print-split.

Nedladdningsbara URL:er till den delade modellen, en per begärt format. Varje del är ett separat objekt i filen. Egenskapen för ett format utelämnas om formatet inte begärdes.

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

true när en by_parts- eller by_color-förfrågans prompt inte namngav 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ärhelst prompten följdes.

Antal utskrivbara delar i den delade modellen — en per objekt i de exporterade filerna. Kollapsade skärvor som segmenteringen inte kunde omvandla till en utskrivbar del tas bort från filerna innan export och räknas inte.

Uppgiftens progress. Om uppgiften ännu inte har startat 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 ännu inte har startat kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften slutfördes, i millisekunder. Om uppgiften ännu inte har slutförts kommer denna egenskap att vara 0.

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

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 fel. Att ta bort en uppgift medan den fortfarande är PENDING återbetalar den också.