Auto Split API

ID:t för uppgiften vars modell som ska delas upp. Uppgiften måste ha statusen SUCCEEDED. Dessa uppgiftstyper fungerar:

• Bild till 3D
• Flera bilder till 3D
• Text till 3D, en preview- eller refine-uppgift
• Omtexturering
• Remesh
• Konvertera
• Ändra storlek

Modellen måste vara genererad med Meshy 6 eller Meshy 7, det vill säga med ai_model satt till meshy-6-lite, meshy-6, meshy-7, meshy-7.1 eller latest. Smart Topology-modeller (meshy-t2 och meshy-t2.5) stöds inte. För en refine-, Omtexturerings-, Remesh-, Konverterings- eller Ändra storlek-uppgift gäller regeln modellen som uppgiften utgick från. En Omtexturerings-, Remesh-, Konverterings- eller Ändra storlek-uppgift som skapats från en uppladdad modell returnerar 400.

Modellen kan ha högst 8 000 000 ytor (faces). En modell med fler ytor returnerar 400. Kör i så fall en Remesh-uppgift på den först, och skicka Remesh-uppgiftens ID istället.

Du kan dela upp en texturerad modell. För att behålla texturen på delarna, skicka keep_texture: true.

Hur modellen ska delas upp i delar.

Tillgängliga värden:

• auto: Meshy väljer skärningarna och ignorerar prompt. En prompt över 600 tecken returnerar fortfarande 400.
• by_parts: Meshy skär längs de strukturella delar du namnger i prompt, till exempel huvud, armar och bål.
• by_color: Meshy skär längs de färgregioner du namnger i prompt. Meshy hittar regionerna i källbilden, inte i inmatningsmodellens textur. Indata måste vara genererad från en uppladdad bild, med Bild till 3D eller Flera bilder till 3D. Andra indata returnerar 400. För Flera bilder till 3D använder Meshy den första källbilden.

Filformaten som ska genereras. Meshy genererar alltid glb och returnerar den i model_urls, plus de övriga format du listar.

Tillgängliga värden:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

Alla format utom stl stöder scenobjekt och håller varje del som ett separat objekt. En STL-fil kan inte innehålla separata objekt, så Meshy sammanfogar delarna till ett enda solidt objekt, arrangerat enligt layout. För att få delar du kan välja separat i en slicer, begär 3mf.

Med keep_texture: true innehåller dessa format texturen:

• glb, fbx, usdz och blend: Texturen finns i filen.
• obj: Texturen finns i materialfilen, som model_urls returnerar under mtl.
• stl och 3mf: Filen innehåller endast geometri, utan texturen.

Hur Meshy arrangerar delarna, i alla filformat och i miniatyren.

Tillgängliga värden:

• assembled: Meshy behåller delarna där de var i källmodellen.
• on_plate: Meshy lägger delarna platt och sprider ut dem på byggplattan, redo att skivas (slice). Detta är samma arrangemang som vyn On Plate i webbappen.

I båda layouterna tar Meshy bort eventuella hopfallna skärvor eller punktliknande bitar som en skärning lämnar efter sig innan export, så varje del du får är utskrivbar. Format som stöder scenobjekt håller ett objekt per del, och stl sammanfogar delarna till ett enda solitt objekt.

Om indatamodellens textur ska behållas på delarna. true ger varje del indatans textur, och uppgiften returnerar kartorna i texture_urls. false ger varje del en platt vertexfärg.

Med true tar uppgiften ungefär dubbelt så lång tid, och credit-kostnaden förändras inte. En otexturerad indata delas upp på samma sätt som med false. Om Meshy inte kan behålla texturen misslyckas uppgiften med felkoden textured_split_refused. Se Fel.

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

Förfrågan kan inte köras. Felmeddelandet anger vilket problem som hittades. Till exempel:

• Saknad prompt: mode är by_parts eller by_color, och prompt saknas.
• Prompten beskriver ingen uppdelning, eller för många delar: Prompten ber om att behålla modellen i ett stycke, eller namnger fler än 10 delar. by_parts och by_color accepterar 1 till 10 namngivna delar. Meshy debiterar inte för förfrågan.
• Ej stödd inmatningsuppgift: input_task_id är inte en lyckad uppgift av en stödd typ, genererad med Meshy 6 eller Meshy 7.
• Ingen referensbild: mode är by_color, och indata genererades inte från en uppladdad bild.
• Koppling utanför intervall: connector_size eller connector_height ligger utanför 0.1 till 0.8.

Åtgärda förfrågan och skicka den igen. Se Fel.

API-nyckeln saknas eller är ogiltig. Kontrollera Authorization-headern.

Till exempel:

• Otillräckliga credits: Kontot har inte tillräckligt med credits för denna uppgift, eller kontot har nått en creditgräns. Kontrollera ditt credit-saldo och försök igen.
• Gratisplan: Att skapa en uppgift kräver en betald plan. Uppgradera din plan i dina prenumerationsinställningar och försök igen.

Något av följande gäller:

• Innehållsmoderering (content moderation) blockerade prompten. Meddelandet är explicit content eller prohibited content. Ändra prompten och försök igen.
• input_task_id är en basreliefmodell, vilket denna endpoint inte kan dela upp. Meddelandet är This model type does not support this operation. Skicka en annan modell.

input_task_id finns inte eller tillhör inte ditt konto. Kontrollera ID:t och använd en API-nyckel från kontot som skapade uppgiften.

Du överskred din hastighetsgräns. Vänta och försök igen. Se Hastighetsgränser.

by_parts- och by_color-förfrågningar delar också en gräns för promptläsning på 12 förfrågningar per minut och konto.

Uppdelning via prompt (by_parts och by_color) är tillfälligt otillgänglig. Försök igen senare, eller skicka mode: "auto", som fortfarande fungerar. Meshy debiterar inte för förfrågan.

Uppgifts-ID:t från skapandesvaret.

ID:t för uppgiften som ska tas bort.

Sidnumret som ska returneras. Börjar på och har som standard 1.

Antalet uppgifter per sida, upp till 100. Standardvärdet är 10. Meshy behandlar ett högre värde som 100.

Sorteringsordningen.

Tillgängliga värden:

• +created_at: äldsta först
• -created_at: nyaste först

Uppgifts-ID:t från skapandesvaret.

Uppgifts-ID:t. Behandla det som en ogenomskinlig sträng och förlita dig inte på dess format.

Uppgiftstypen, alltid print-split.

Nedladdnings-URL:er för den uppdelade modellen, en per format du begärde. Ett format du inte begärde har ingen nyckel. Format som stöder scenobjekt behåller varje del som ett separat objekt, och stl smälter samman delarna till en enda solid.

Nedladdnings-URL för en förhandsgranskningsbild av den uppdelade modellen, i den layout du begärde. När delarna behåller en textur visar förhandsgranskningen den. Annars har varje del sin egen färg.

Texturkartorna för den uppdelade modellen, som en array med ett objekt. Alla delar delar dessa kartor. Finns endast när keep_texture är true och indatamodellen är texturerad.

Nedladdnings-URL för en version av thumbnail_url med transparent bakgrund (RGBA). Finns endast efter att uppgiften lyckats, när Meshy renderat den transparenta förhandsgranskningen.

Om Meshy ignorerade prompten. Den är true när prompt i en by_parts- eller by_color-begäran inte namngav några delar, så Meshy delade upp modellen automatiskt istället. Delnamnen i resultatet är då Meshys, inte dina. Finns med från PENDING och framåt. Meshy utelämnar den för auto-uppgifter och närhelst den följde prompten.

Antalet utskrivbara delar som uppdelningen gav. Format som stöder scenobjekt har ett objekt per del. stl smälter samman delarna till en solid, men part_count räknar dem ändå. Före export tar Meshy bort kollapsade flisor som inte kan bli en utskrivbar del, och räknar inte med dem.

Hur mycket av uppgiften som är klar, i procent. Den är 0 tills uppgiften startar och 100 när den lyckas.

Uppgiftsstatusen, en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED eller CANCELED.

Antalet uppgifter före denna i kön. Värdet är meningsfullt endast medan uppgiften är PENDING.

Tidpunkt då uppgiften skapades, i Unix-millisekunder.

Tidpunkt då uppgiften startade, i Unix-millisekunder. Den är 0 tills uppgiften startar.

Tidpunkt då uppgiften avslutades, i Unix-millisekunder. Den är 0 tills uppgiften avslutas.

Tidpunkt då uppgiftens resultat upphör att gälla, i Unix-millisekunder. Den är 0 tills uppgiften avslutas.

Feldetaljerna när uppgiften misslyckas. Se Fel.

Om en säkerhetskontroll avvisar indatamodellen misslyckas uppgiften med task_error.type satt till invalid_input och task_error.code satt till provider_content_refused. Skicka en annan modell. Se Fel.

Med keep_texture: true, om Meshy inte kan behålla texturen, misslyckas uppgiften med task_error.code satt till textured_split_refused. Se Fel.

Antalet credits uppgiften använde. Den finns alltid med. Den är 10 efter att Meshy accepterat uppgiften, och 0 för en FAILED-uppgift, eftersom Meshy återbetalar credits när en uppgift misslyckas. Att ta bort en PENDING-uppgift återbetalar den också.