Remesh API

ID för den slutförda Bild till 3D eller Text till 3D-uppgiften du vill remesh. Denna uppgift måste vara en av följande uppgifter: Text till 3D Förhandsvisning, Text till 3D Förfina, Bild till 3D eller Omtexturering. Dessutom måste den ha statusen SUCCEEDED.

Vänligen tillhandahåll en 3D-modell för Meshy att remesh via en offentligt tillgänglig URL eller data URI. Stödda format: .glb, .gltf, .obj, .fbx, .stl.

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

En lista över målformat för den remeshade modellen. När den utelämnas genereras endast GLB.

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

Specificera topologin för den genererade modellen.

Tillgängliga värden:

• quad: Generera ett quad-dominerande nät.
• triangle: Generera ett decimerat triangelnät.

Specificera det önskade antalet polygoner i den genererade modellen. Det faktiska antalet polygoner kan avvika från målet beroende på komplexiteten i geometrin.

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

• 100 till 300,000 (inklusive)

Aktivera adaptiv decimering genom att ställa in en polygonantalnivå. När den är inställd ignoreras target_polycount.

Tillgängliga värden:

• 1: Adaptiv — ultra polygonantal.
• 2: Adaptiv — högt polygonantal.
• 3: Adaptiv — medel 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 av begränsningsboxen motsvarar det angivna värdet i meter. Vi rekommenderar att använda den dedikerade Resize API istället.

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

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

När den är inställd på 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 förblir oförändrat.

Begäran var oacceptabel. Vanliga orsaker:

• Saknad parameter: Antingen model_url eller input_task_id måste tillhandahållas.
• Ogiltig inmatningsuppgift: input_task_id måste referera till en lyckad uppgift från en stödd modell.
• Ogiltigt modelformat: model_url pekar på en fil med en icke-stödd filändelse.
• Oåtkomlig URL: model_url kunde inte laddas ner.
• Ogiltig topologi: topology-parametern är ogiltig.
• Ömsesidigt uteslutande parametrar: auto_size och resize_height kan inte båda ställas in.

Autentisering misslyckades. Vänligen kontrollera din API-nyckel.

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

Du har överskridit din hastighetsgräns.

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

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

Sidnummer för paginering.

Sidstorleksgräns. Max 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 Remesh-uppgiften att strömma.

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 formatet på id:t.

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

Nedladdningsbar URL till den texturerade 3D-modellfilen som genereras av Meshy. Egenskapen för ett format kommer att 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). Endast närvarande när uppgiften skapades med alpha_thumbnail: true och den transparenta förhandsgranskningen renderades framgångsrikt; annars utelämnas detta fält.

Framsteg för uppgiften. Om uppgiften inte har startat ännu, kommer denna egenskap att vara 0. När uppgiften har lyckats, kommer detta att bli 100.

Status för uppgiften. Möjliga värden är en 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 ännu, kommer denna egenskap att vara 0.

Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften inte har avslutats ännu, kommer denna egenskap att vara 0.

Felformation för misslyckade uppgifter. Se Fel för fullständig referens till task_error-objektet.

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