Remesh API

Het ID van de voltooide Afbeelding naar 3D- of Tekst naar 3D-taak die u wilt remeshen. Deze taak moet een van de volgende taken zijn: Text to 3D Preview, Text to 3D Refine, Afbeelding naar 3D of Hertextureren. Bovendien moet de status SUCCEEDED zijn.

Geef een 3D-model op dat Meshy moet remeshen via een publiek toegankelijke URL of data-URI. Ondersteunde formaten: .glb, .gltf, .obj, .fbx, .stl.

Gebruik voor Data URI's het MIME type: application/octet-stream.

Een lijst met doelformaten voor het geremeshte model. Indien weggelaten, wordt alleen GLB gegenereerd.

Beschikbare waarden: glb, fbx, obj, usdz, blend, stl, 3mf.

Geef de topology van het gegenereerde model op.

Beschikbare waarden:

• quad: Genereert een overwegend quad-mesh.
• triangle: Genereert een gedecimeerde driehoeksmesh.

Geef het beoogde aantal polygonen in het gegenereerde model op. Het werkelijke aantal polygonen kan afwijken van het doel, afhankelijk van de complexiteit van de geometrie.

Het geldige waardebereik varieert afhankelijk van het gebruikersniveau:

• 100 tot 300.000 (inclusief)

Schakel adaptieve decimatie in door een polygoonaantal-niveau in te stellen. Wanneer dit is ingesteld, wordt target_polycount genegeerd.

Beschikbare waarden:

• 1: Adaptief — ultrahoog polygonaantal.
• 2: Adaptief — hoog polygonaantal.
• 3: Adaptief — gemiddeld polygonaantal.
• 4: Adaptief — laag polygonaantal.

Wijzig het formaat van het model naar een bepaalde hoogte in meters. We raden aan hiervoor de speciale Resize API te gebruiken.

Wijzig het formaat van het model zodat de langste dimensie van de bounding box gelijk is aan de opgegeven waarde in meters. We raden aan hiervoor de speciale Resize API te gebruiken.

Wanneer ingesteld op true, gebruikt de service AI-vision om automatisch de werkelijke hoogte van het object te schatten en het formaat van het model dienovereenkomstig aan te passen. We raden aan hiervoor de speciale Resize API te gebruiken.

Als dit true is, zal de service alleen het formaat van het invoermodelbestand wijzigen, waarbij andere invoerwaarden zoals topology, resize_height en target_polycount worden genegeerd. We raden aan hiervoor de speciale Convert API te gebruiken.

Wanneer ingesteld op true, rendert de taak bovendien een versie van de preview met transparante achtergrond (RGBA) en retourneert deze als alpha_thumbnail_url in de GET-respons. Het bestaande veld thumbnail_url blijft ongewijzigd.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Er moet ofwel model_url ofwel input_task_id worden opgegeven.
• Ongeldige invoertaak: input_task_id moet verwijzen naar een geslaagde taak van een ondersteund model.
• Ongeldig modelformaat: model_url verwijst naar een bestand met een niet-ondersteunde extensie.
• Onbereikbare URL: model_url kon niet worden gedownload.
• Ongeldige topology: De parameter topology is ongeldig.
• Onderling uitsluitende parameters: auto_size en resize_height kunnen niet allebei worden ingesteld.

Authenticatie mislukt. Controleer uw API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

U heeft uw rate limit overschreden.

De ID van de remesh-taak die moet worden opgehaald.

De ID van de te verwijderen remesh-taak.

Paginanummer voor paginering.

Limiet voor paginagrootte. Maximaal toegestaan is 50 items.

Veld om op te sorteren.

Beschikbare waarden:

• +created_at: Sorteren op aanmaaktijd in oplopende volgorde.
• -created_at: Sorteren op aanmaaktijd in aflopende volgorde.

Unieke identifier voor de Remesh-taak die gestreamd moet worden.

Unieke identificatie voor de taak. Hoewel we voor taak-id's een k-sorteerbare UUID gebruiken als implementatiedetail, mag je geen aannames doen over de indeling van de id.

Type van de Remesh-taak. De waarde is remesh.

Downloadbare URL naar het door Meshy gegenereerde 3D-modelbestand met textuur. De eigenschap voor een formaat wordt weggelaten als het formaat niet is gegenereerd, in plaats van een lege string terug te geven.

Downloadbare URL naar een voorbeeldafbeelding die is gerenderd op basis van het geremeshte model.

Downloadbare URL naar een versie van thumbnail_url met transparante achtergrond (RGBA). Alleen aanwezig wanneer de taak is aangemaakt met alpha_thumbnail: true en het transparante voorbeeld succesvol is gerenderd; anders wordt dit veld weggelaten.

Voortgang van de taak. Als de taak nog niet is gestart, is deze eigenschap 0. Zodra de taak is geslaagd, wordt dit 100.

Status van de taak. Mogelijke waarden zijn een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED.

Het aantal voorgaande taken.

Tijdstempel van wanneer de taak is aangemaakt, in milliseconden.

Tijdstempel van wanneer de taak is gestart, in milliseconden. Als de taak nog niet is gestart, is deze eigenschap 0.

Tijdstempel van wanneer de taak is voltooid, in milliseconden. Als de taak nog niet is voltooid, is deze eigenschap 0.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige task_error-objectreferentie.

Het aantal credits dat door deze taak is verbruikt. Aanwezig wanneer de taakstatus PENDING, IN_PROGRESS of SUCCEEDED is. Geeft 0 terug voor FAILED-taken (credits worden bij mislukken terugbetaald).