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: Tekst naar 3D Preview, Tekst naar 3D Refine, Afbeelding naar 3D of Hertextureren. Daarnaast moet de status SUCCEEDED zijn.

Geef Meshy een 3D-model om te 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.

Maximale bestandsgrootte: 400 MB voor een http- of https-URL, 100 MB voor een data:-URI.

Een GLB-, glTF-, FBX- of OBJ-bestand groter dan 100 MB mag maximaal 10.000.000 vlakken bevatten. Vlakken worden geteld als driehoeken: een vierhoek telt als 2, en een mesh die meerdere keren wordt getekend, telt één keer per kopie. Boven 100 MB moet een FBX-bestand binaire FBX 7.1 of nieuwer zijn, en mag een GLB- of glTF-bestand geen Draco-compressie gebruiken.

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: Genereer een mesh die overwegend uit vierhoeken bestaat.
• 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 bereik is 100 tot 300.000 (inclusief).

Schakel adaptieve decimatie in door een polygoonaantal-niveau in te stellen. Indien 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 in meters. We raden aan hiervoor de speciale Resize API 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 hiervoor de speciale Resize API te gebruiken.

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

Als dit op true staat, wijzigt de service alleen het formaat van het invoermodelbestand en negeert daarbij andere invoer zoals topology, resize_height en target_polycount. We raden aan hiervoor de speciale Convert API te gebruiken.

Als dit op true is ingesteld, 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 onacceptabel. Veelvoorkomende oorzaken:

• Ontbrekende parameter: Er moet ofwel model_url ofwel input_task_id 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.
• Modelbestand te groot: Het bestand bij model_url is groter dan 400 MB (http- of https-URL) of 100 MB (data:-URI).
• Te veel vlakken: Het bestand bij model_url is groter dan 100 MB en heeft meer dan 10.000.000 vlakken. Verminder het aantal vlakken en verstuur het bestand opnieuw.
• ASCII FBX groter dan 100 MB: Het bestand bij model_url is een ASCII FBX groter dan 100 MB. Verstuur het als binaire FBX of GLB.
• Onleesbaar modelbestand: Het bestand bij model_url is groter dan 100 MB en de header kan niet worden gelezen, bijvoorbeeld een Draco-gecomprimeerde GLB of glTF, of een binaire FBX ouder dan 7.1.
• Modelheader te complex: Het bestand bij model_url is groter dan 100 MB en de header bevat te veel meshes, nodes of records om te controleren. Verminder het aantal objecten in het bestand en verstuur het opnieuw.
• Ongeldige topology: De parameter topology is ongeldig.
• Elkaar uitsluitende 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 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).