Remesh API

ID:t för den slutförda Bild till 3D- eller Text till 3D-uppgiften du vill remescha. 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 för Meshy att remescha via en publikt tillgänglig URL eller data URI. Format som stöds: .glb, .gltf, .obj, .fbx, .stl.

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

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

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

Ange topologin 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 den är inställd 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 det dedikerade Resize API.

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

När detta är satt till true använder tjänsten AI-syn för att automatiskt uppskatta objektets verkliga höjd och ändra modellens storlek därefter. Vi rekommenderar att du istället använder det dedikerade Resize API.

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

När detta är satt 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 var oacceptabel. Vanliga orsaker:

• Saknad parameter: Antingen model_url eller input_task_id måste anges.
• Ogiltig ingångsuppgift: 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 ett filtillägg som inte stöds.
• Onåbar URL: model_url kunde inte laddas ner.
• Ogiltig topology: Parametern topology är ogiltig.
• Ömsesidigt uteslutande parametrar: auto_size och resize_height kan inte vara satta samtidigt.

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 den remesh-uppgift som ska hämtas.

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

Sidnummer för paginering.

Gräns för sidstorlek. Maximalt tillåtet är 100 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 streamas.

Unik identifierare för uppgiften. Även om vi använder en k-sorterbar UUID för uppgifts-id:n 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 har genererats, istället för att returnera en tom sträng.

Nedladdningsbar URL till en förhandsvisningsbild 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örhandsvisningen renderades framgångsrikt; annars utelämnas detta fält.

Uppgiftens progress. Om uppgiften ännu inte har påbörjats är denna egenskap 0. När uppgiften har lyckats blir den 100.

Uppgiftens status. 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 ännu inte har startats är denna egenskap 0.

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

Feldetaljer för misslyckade uppgifter. Se Fel för den fullständiga referensen till 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 uppgifter med FAILED (credits återbetalas vid misslyckande).