Auto Split API

ID:t för en lyckad uppgift vars modell ska delas. Uppgiftstyper som stöds: Bild till 3D, Flera bilder till 3D, Text till 3D (förhandsvisning), Remesh, Konvertera och Ändra storlek. Uppgiften måste ha statusen 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) 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 snitten. 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ärgregioner du namnger i prompt. Kräver en indata genererad 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 som den uppdelade modellen ska exporteras i. Format som stöder scenobjekt (glb, obj, fbx, usdz, blend, 3mf) bär varje del som ett separat objekt; stl har ingen uppfattning om separata objekt, så det slår samman varje del till ett enda solidt objekt arrangerat enligt layout (begär 3mf för separat valbara delar i en slicer). glb produceras alltid och returneras i model_urls; ange eventuella övriga 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 miniatyren.

Tillgängliga värden:

• assembled: Delarna behåller samma placering som i källmodellen.
• on_plate: Delarna läggs platt och utspridda på byggplattan, redo att skäras — samma arrangemang som webbappens On Plate-vy.

I båda arrangemangen tas en hopfallen sliver eller punktliknande bit som blir kvar från ett snitt bort före export, så varje del du får är utskrivbar. Format som stöder scenobjekt håller ett objekt per del; stl slår samman dem till ett enda solitt objekt.

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

Begäran var inte godtagbar. 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 begär att modellen behålls i ett enda stycke, eller som 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 genererad 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äckligt med 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 också på en gräns för prompt-tolkning på 12 förfrågningar per minut och 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 tas bort.

Sidnummer för paginering. Börjar 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 Auto Split-uppgiften 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 formatet på id:t.

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 slår samman dem till ett enda solidt objekt. 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-begärans prompt inte namngav några delar, så Meshy delade modellen automatiskt istället — delnamnen i resultatet är Meshys, inte dina. Finns från PENDING och framåt. Utelämnas för auto-uppgifter och när prompten följdes.

Antal utskriftsbara delar som delningen producerade. Format som stöder scenobjekt bär ett objekt per del; stl slår samman dem till ett enda solidt objekt, och antalet rapporterar fortfarande delarna. Kollapsade flisor som segmenteringen inte kunde omvandla till en utskriftsbar del tas bort från filerna före export och räknas inte.

Uppgiftens progress. Om uppgiften inte har startat ännu blir denna egenskap 0. Så snart 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 blir denna egenskap 0.

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

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

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