Remesh API

De ID van de voltooide Afbeelding naar 3D- of Tekst naar 3D-taak die je wilt remeshen. Deze taak moet een van de volgende taken zijn: Tekst naar 3D Preview, Tekst naar 3D Refine, Afbeelding naar 3D of Hertextureren. Daarnaast moet deze de status SUCCEEDED hebben.

Geef een 3D-model op dat Meshy kan 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 ge-remeshte model. Wanneer dit wordt weggelaten, wordt alleen GLB gegenereerd.

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

Specificeer de topology van het gegenereerde model.

Beschikbare waarden:

• quad: Genereer een quad-dominante mesh.
• triangle: Genereer een gedecimeerde driehoeksmesh.

Specificeer het beoogde aantal polygonen in het gegenereerde model. 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 en met 300.000 (inclusief)

Schakel adaptieve decimatie in door een polygonaantalniveau 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, gemeten in meters. We raden aan in plaats daarvan de speciale Resize API te gebruiken.

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

Wanneer ingesteld op true, gebruikt de service AI-visie om automatisch de echte hoogte van het object te schatten en het formaat van het model dienovereenkomstig te wijzigen. We raden aan in plaats daarvan de speciale Resize API te gebruiken.

Als true, wijzigt de service alleen het formaat van het invoermodelbestand en negeert andere invoer zoals topology, resize_height en target_polycount. We raden aan in plaats daarvan de speciale Convert API te gebruiken.

Wanneer ingesteld op true, rendert de taak aanvullend 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.

De aanvraag was ongeldig. Veelvoorkomende oorzaken:

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

Authenticatie mislukt. Controleer je API-sleutel.

Onvoldoende credits om deze taak uit te voeren.

Je hebt je rate limit overschreden.

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

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

Paginanummer voor paginering.

Limiet voor paginagrootte. Maximaal toegestaan is 50 items.

Veld om op te sorteren.

Beschikbare waarden:

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

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

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

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

Downloadbare URL naar het 3D-modelbestand met texture dat door Meshy is gegenereerd. De eigenschap voor een formaat wordt weggelaten als het formaat niet wordt gegenereerd, in plaats van een lege tekenreeks te retourneren.

Downloadbare URL naar een voorbeeldafbeelding die is gerenderd vanuit het geremeshte model.

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

Progress 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 voorafgaande 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 objectreferentie van task_error.

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