Remesh API

ID:t för den slutförda Bild till 3D- eller Text till 3D-uppgift som du vill utföra remesh på. Denna uppgift måste vara en av följande uppgifter: 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 utföra remesh på via en offentligt åtkomlig URL eller Data URI. Format som stöds: .glb, .gltf, .obj, .fbx, .stl.

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

En lista över målformat för den remeshade modellen. Om den 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: Generera ett quad-dominerat nät.
• triangle: Generera ett decimerat triangelnät.

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

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

• 100 till 300 000 (inklusive)

Aktivera adaptiv decimering genom att ange en nivå för polygonantal. När den anges 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 använda den dedikerade Resize API istället.

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

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

Om true kommer tjänsten endast att ändra formatet på inmatningsmodellfilen och ignorera andra indata som topology, resize_height och target_polycount. Vi rekommenderar att använda den dedikerade Convert API istället.

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

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: Antingen model_url eller input_task_id måste anges.
• Ogiltig inmatningsuppgift: input_task_id måste hänvisa till en lyckad uppgift från en modell som stöds.
• Ogiltigt modellformat: model_url pekar på en fil med ett tillägg som inte stöds.
• Oåtkomlig URL: model_url kunde inte laddas ned.
• Ogiltig topology: Parametern topology är ogiltig.
• Ömsesidigt uteslutande parametrar: auto_size och resize_height kan inte båda anges.

Autentisering 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 remesh-uppgiften som ska hämtas.

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

Sidnummer för paginering.

Gräns för sidstorlek. Högsta tillåtna ä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 Remesh-uppgiften som ska strömmas.

Unik identifierare för uppgiften. Även om vi använder ett k-sorterbart UUID för uppgifts-id:n som implementeringsdetalj bör du inte göra några antaganden om id:ts format.

Typ av Remesh-uppgiften. 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, i stället för att returnera en tom sträng.

Nedladdningsbar URL till en förhandsvisningsbild som renderats från den omnätade modellen.

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

Uppgiftens progress. Om uppgiften inte har startats ännu är den här egenskapen 0. När uppgiften har slutförts framgångsrikt blir den 100.

Uppgiftens status. Möjliga värden är ett av PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Antalet föregående uppgifter.

En tidsstämpel för när uppgiften skapades, i millisekunder.

En tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startats ännu är den här egenskapen 0.

En tidsstämpel för när uppgiften slutfördes, i millisekunder. Om uppgiften inte är slutförd ännu är den här egenskapen 0.

Felinformation för misslyckade uppgifter. Se Fel för den fullständiga objektreferensen för task_error.

Antalet credits som förbrukats av den här uppgiften. Finns när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED-uppgifter (credits återbetalas vid fel).