Remesh API

De 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, Image to 3D of Retexture. 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.

Voor Data URI's, gebruik het MIME type: application/octet-stream.

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

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

Geef de topology van het gegenereerde model op.

Beschikbare waarden:

• quad: Genereer een mesh met voornamelijk quads.
• triangle: Genereer een gedecimeerde driehoeksmesh.

Geef het gewenste 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 ingesteld, wordt target_polycount genegeerd.

Beschikbare waarden:

• 1: Adaptief — ultra 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 de speciale Resize API hiervoor te gebruiken.

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

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

Als true, zal de service alleen het formaat van het invoermodelbestand wijzigen, waarbij andere invoer zoals topology, resize_height en target_polycount wordt genegeerd. We raden aan de speciale Convert API hiervoor 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 thumbnail_url-veld blijft ongewijzigd.

Het verzoek was onaanvaardbaar. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Ofwel model_url ofwel input_task_id moet worden opgegeven.
• Ongeldige invoertaak: input_task_id moet verwijzen naar een succesvolle 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.
• Elkaar 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.

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

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

Paginanummer voor paginering.

Paginagroottelimiet. Maximaal toegestaan is 100 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 identificatie voor de Remesh-taak die gestreamd moet worden.

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

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

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

Downloadbare URL naar een voorbeeldafbeelding gerenderd vanuit 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.

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 beëindigd, in milliseconden. Als de taak nog niet is beëindigd, is deze eigenschap 0.

Foutdetails voor mislukte taken. Zie Fouten voor de volledige task_error object-referentie.

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 bij falen terugbetaald).