Remesh API

Krävs om du inte skickar model_url. ID:t för uppgiften vars modell du vill remesh:a, till exempel en Text till 3D-, Bild till 3D-, Omtexturerings- eller Remesh-uppgift. Uppgiften måste vara en som du skapade med API:et och ha statusen SUCCEEDED.

Krävs om du inte skickar input_task_id. Modellen som ska remeshas, som en offentlig URL eller en data-URI. Om du skickar båda använder Meshy input_task_id.

Modellen måste vara en GLB-, glTF-, OBJ-, FBX- eller STL-fil på högst 400 MB från en http- eller https-URL, eller 100 MB som en data-URI. För en data-URI, använd MIME type application/octet-stream.

En fil över 100 MB måste också följa dessa regler:

• En GLB-, glTF-, FBX- eller OBJ-fil kan ha högst 10 000 000 ytor. Meshy räknar ytor som trianglar, så en fyrhörning räknas som 2, och ett nät som ritas flera gånger räknas en gång per kopia.
• En FBX-fil måste vara binär FBX 7.1 eller nyare.
• En GLB- eller glTF-fil får inte använda Draco-komprimering.

Filformaten som ska genereras.

Tillgängliga värden:

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

Ytans typ för den remeshade modellen.

Tillgängliga värden:

• quad: ett nät som domineras av fyrhörningar
• triangle: ett decimerat triangelnät

Antalet ytor att sikta mot, från 100 till 300000. Resultatet kan skilja sig från målet, beroende på modellens geometri. Ett värde utanför intervallet returnerar 400.

Adaptivt ytantal, per nivå. När du anger detta ignorerar Meshy target_polycount.

Tillgängliga värden:

• 1: ultra
• 2: hög
• 3: medel
• 4: låg

Använd Resize API istället. Höjden att ändra modellens storlek till, i meter. Skicka högst en av resize_height, resize_longest_side och auto_size.

Använd Resize API istället. Längden att ändra modellens begränsningsrutas längsta sida till, i meter. Skicka högst en av resize_height, resize_longest_side och auto_size.

Använd Resize API istället. Huruvida objektets verkliga höjd ska uppskattas med AI-seende och modellen ändras till den storleken. Skicka högst en av resize_height, resize_longest_side och auto_size.

Använd Resize API istället. Var modellens origo ska placeras, bottom eller center. Standardvärdet gäller när du skickar resize_height, resize_longest_side eller auto_size. Utan någon av dem flyttar Meshy origo endast om du skickar origin_at.

Använd Convert API istället. Huruvida modellen bara ska konverteras till target_formats. När true ignorerar Meshy topology, target_polycount, decimation_mode, resize_height, resize_longest_side och auto_size, men kontrollerar ändå deras värden, så ett ogiltigt värde returnerar 400. Med convert_format_only: true returnerar en tom eller null target_formats 400.

Huruvida en förhandsgranskning med transparent bakgrund (RGBA) också ska renderas, som returneras i alpha_thumbnail_url när du hämtar uppgiften. thumbnail_url ändras inte.

Begäran kan inte köras. Felmeddelandet anger vilket problem som hittades. Till exempel:

• Saknad parameter: Varken model_url eller input_task_id skickades.
• Ogiltig indatauppgift: input_task_id är inte en lyckad API-uppgift, eller dess AI-modell stöder inte remeshing.
• Ogiltigt modellformat: Filen i model_url har ett filtillägg som inte stöds.
• Oåtkomlig URL: Meshy kan inte ladda ner filen i model_url.
• Modellfilen är för stor: Filen i model_url är över 400 MB från en http- eller https-URL, eller över 100 MB som en data-URI.
• För många ytor: Filen i model_url är över 100 MB och har fler än 10 000 000 ytor. Minska antalet ytor och skicka sedan filen igen.
• ASCII FBX över 100 MB: Filen i model_url är en ASCII FBX över 100 MB. Skicka den som binär FBX eller GLB.
• Oläsbar modellfil: Filen i model_url är över 100 MB, och Meshy kan inte läsa dess header. Till exempel är den en Draco-komprimerad GLB eller glTF, eller en binär FBX äldre än 7.1.
• Modellens header är för komplex: Filen i model_url ä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 topology: topology är varken quad eller triangle.
• Ömsesidigt uteslutande parametrar: Begäran innehåller mer än en av auto_size, resize_height och resize_longest_side. Skicka bara en.

Åtgärda begäran och skicka den sedan igen. Se Fel.

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

Till exempel:

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

input_task_id är en basreliefmodell, vilket den här endpointen inte kan remesh:a. Meddelandet är This model type does not support this operation. Skicka en annan modell.

input_task_id matchar ingen av dina uppgifter. Kontrollera uppgifts-ID:t och skicka sedan begäran igen.

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

Uppgifts-ID:t från skaparsvaret.

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

Sidnumret som ska returneras, upp till 255. Ett större värde returnerar 400.

Antalet uppgifter per sida, upp till 100.

Sorteringsordningen.

Tillgängliga värden:

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

Uppgifts-ID från skapandesvaret.

Uppgifts-ID:t. Behandla det som en opak sträng och lita inte på dess format.

Uppgiftstypen, alltid remesh.

Nedladdningslänkar för den remeshade modellen, en per filformat. Ett format som uppgiften inte genererade saknar nyckel, istället för att ha en tom sträng.

Nedladdningslänk för en förhandsgranskningsbild av den remeshade modellen.

Nedladdningslänk för en version av thumbnail_url med transparent bakgrund (RGBA). Finns endast om du skapade uppgiften med alpha_thumbnail: true och Meshy renderade den transparenta förhandsgranskningen.

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

Uppgiftens status, en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED eller CANCELED.

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

Tidpunkten då uppgiften skapades, i Unix-millisekunder.

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

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

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

Nedladdningslänkar för modellens texturkartor, när uppgiften lyckas: en array av objekt, ett per texturset. Varje objekt har en base_color-URL, och kan även ha metallic-, roughness-, normal-, emission- och metallic_roughness-URL:er. Den är null tills uppgiften lyckas, och en tom array när modellen saknar texturkartor.

Feldetaljerna när uppgiften misslyckas. Se Fel.

Antalet credits som uppgiften förbrukade. Finns när statusen är PENDING, IN_PROGRESS eller SUCCEEDED. Den är 0 för en FAILED-uppgift, eftersom Meshy återbetalar credits när en uppgift misslyckas.