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 Voorbeeld, Tekst naar 3D Verfijnen, Afbeelding naar 3D of Hertextureren. Bovendien moet het een status van SUCCEEDED hebben.

Geef een 3D-model voor Meshy om te remeshen via een openbaar toegankelijke URL of data URI. Ondersteunde formaten: .glb, .gltf, .obj, .fbx, .stl.

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

Een lijst van doelformaten voor het geremeshte model. Als 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 triangle mesh.

Specificeer het doel polygonaantal 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 300,000 (inclusief)

Schakel adaptieve decimatie in door een polygonaantalniveau 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 om de speciale Resize API te gebruiken.

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

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

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

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

Het verzoek was onacceptabel. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Ofwel model_url of input_task_id moet worden verstrekt.
• Ongeldige invoertaak: De input_task_id moet verwijzen naar een succesvolle taak van een ondersteund model.
• Ongeldig modelformaat: De model_url wijst naar een bestand met een niet-ondersteunde extensie.
• Onbereikbare URL: De model_url kon niet worden gedownload.
• Ongeldige topology: De topology parameter is ongeldig.
• Wederzijds exclusieve parameters: auto_size en resize_height kunnen niet beide 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 remesh taak die moet worden verwijderd.

Paginanummer voor paginering.

Limiet voor paginagrootte. Maximum toegestaan is 50 items.

Veld om op te sorteren.

Beschikbare waarden:

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

Unieke identificatie voor de Remesh taak om te streamen.

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

Type van de Remesh taak. De waarde is remesh.

Downloadbare URL naar het getextureerde 3D-modelbestand gegenereerd door Meshy. 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 gerenderd van het geremeshede 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 de transparante preview succesvol is gerenderd; anders wordt dit veld weggelaten.

Voortgang van de taak. Als de taak nog niet is gestart, zal deze eigenschap 0 zijn. 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, zal deze eigenschap 0 zijn.

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

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