Remesh API

ID:t för den slutförda Bild till 3D- eller Text till 3D-uppgift som du vill remesha. Denna uppgift måste vara en av följande uppgiftstyper: Text till 3D Preview, Text till 3D Refine, Bild till 3D eller Omtexturering. Dessutom måste den ha statusen SUCCEEDED.

Ange en 3D-modell som Meshy ska remesha via en publikt tillgänglig URL eller data-URI. Format som stöds: .glb, .gltf, .obj, .fbx, .stl.

För Data URI, använd MIME type: application/octet-stream.

En lista med målformat för den remeshade modellen. Om detta utelämnas genereras endast GLB.

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

Ange topology för den genererade modellen.

Tillgängliga värden:

• quad: Genererar ett nät som domineras av quads.
• triangle: Genererar ett decimerat triangelnät.

Ange målantalet polygoner i den genererade modellen. Det faktiska antalet polygoner kan avvika från målet beroende på geometrins komplexitet.

Det giltiga värdeintervallet varierar beroende på användarnivå:

• 100 till 300 000 (inklusive)

Aktivera adaptiv decimering genom att ange en polygonantal-nivå. När detta är satt ignoreras target_polycount.

Tillgängliga värden:

• 1: Adaptiv — ultrahögt polygonantal.
• 2: Adaptiv — högt polygonantal.
• 3: Adaptiv — medelhögt polygonantal.
• 4: Adaptiv — lågt polygonantal.

Ändra storlek på modellen till en viss höjd mätt i meter. Vi rekommenderar att du istället använder den dedikerade Resize API.

Ändra storlek på modellen så att den längsta dimensionen i dess bounding box motsvarar det angivna värdet i meter. Vi rekommenderar att du istället använder den dedikerade Resize API.

När detta sätts till true använder tjänsten AI-baserad synanalys för att automatiskt uppskatta objektets verkliga höjd och ändra storlek på modellen därefter. Vi rekommenderar att du istället använder den dedikerade Resize API.

Om true kommer tjänsten endast att ändra format på indatamodellens fil och ignorera andra indata som topology, resize_height och target_polycount. Vi rekommenderar att du istället använder den dedikerade Convert API.

När detta sätts till true renderar uppgiften dessutom en version av förhandsgranskningen med transparent bakgrund (RGBA) och returnerar den som alpha_thumbnail_url i GET-svaret. Det befintliga fältet thumbnail_url förblir oförändrat.

Begäran kunde inte accepteras. Vanliga orsaker:

• Saknad parameter: Antingen model_url eller input_task_id måste anges.
• Ogiltig indatauppgift: input_task_id måste referera till en lyckad uppgift från en modell som stöds.
• Ogiltigt modellformat: model_url pekar på en fil med en filändelse som inte stöds.
• Onåbar URL: model_url kunde inte hämtas.
• Ogiltig topology: Parametern topology är ogiltig.
• Ömsesidigt uteslutande parametrar: auto_size och resize_height kan inte anges samtidigt.

Autentiseringen misslyckades. Kontrollera din API-nyckel.

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

Du har överskridit din hastighetsgräns.

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

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

Sidnummer för paginering.

Gräns för sidstorlek. Maximalt tillåtet är 50 objekt.

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 Remesh-uppgift 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.

Typ av Remesh-uppgift. Värdet är remesh.

Nedladdningsbar URL till den texturerade 3D-modellfilen som genererats av Meshy. Egenskapen för ett format utelämnas om formatet inte genereras, istället för att returnera en tom sträng.

Nedladdningsbar URL till en förhandsgranskningsbild renderad från den remeshade modellen.

Nedladdningsbar URL till en version av thumbnail_url med transparent bakgrund (RGBA). Finns endast med när uppgiften skapades med alpha_thumbnail: true och den transparenta förhandsgranskningen renderades framgångsrikt; annars utelämnas detta fält.

Progress för uppgiften. Om uppgiften inte har startat än är denna egenskap 0. När uppgiften har lyckats blir den 100.

Status för uppgiften. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

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 än är denna egenskap 0.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften inte är klar än är denna egenskap 0.

Feldetaljer för misslyckade uppgifter. Se Fel för hela referensen för task_error-objektet.

Antalet credits som förbrukats av denna uppgift. Finns med när uppgiftens status är PENDING, IN_PROGRESS, eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid misslyckande).