Remesh API

Vereist, tenzij u model_url meestuurt. De ID van de taak waarvan u het model wilt remeshen, bijvoorbeeld een Tekst naar 3D-, Afbeelding naar 3D-, Hertextureren- of Remesh-taak. De taak moet er een zijn die u met de API heeft aangemaakt en de status SUCCEEDED hebben.

Vereist, tenzij u input_task_id meestuurt. Het model om te remeshen, als een publieke URL of een data-URI. Als u beide meestuurt, gebruikt Meshy input_task_id.

Het model moet een GLB-, glTF-, OBJ-, FBX- of STL-bestand zijn van maximaal 400 MB vanaf een http- of https-URL, of 100 MB als data-URI. Gebruik voor een data-URI het MIME type application/octet-stream.

Een bestand groter dan 100 MB moet ook aan deze regels voldoen:

• Een GLB-, glTF-, FBX- of OBJ-bestand mag maximaal 10.000.000 vlakken hebben. Meshy telt vlakken als driehoeken, dus een quad telt als 2, en een mesh die meerdere keren wordt getekend telt één keer per kopie.
• Een FBX-bestand moet binaire FBX 7.1 of nieuwer zijn.
• Een GLB- of glTF-bestand mag geen Draco-compressie gebruiken.

De te genereren bestandsindelingen.

Beschikbare waarden:

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Het vlaktype van het geremeshte model.

Beschikbare waarden:

• quad: een overwegend uit quads bestaande mesh
• triangle: een gedecimeerde driehoeksmesh

Het beoogde aantal vlakken, van 100 tot 300000. Het resultaat kan afwijken van het doel, afhankelijk van de geometrie van het model. Een waarde buiten het bereik geeft 400 terug.

Adaptief aantal vlakken, per niveau. Wanneer u dit instelt, negeert Meshy target_polycount.

Beschikbare waarden:

• 1: ultra
• 2: hoog
• 3: gemiddeld
• 4: laag

Gebruik in plaats daarvan de Resize API. De hoogte om het model op te schalen, in meters. Stuur maximaal één van resize_height, resize_longest_side en auto_size.

Gebruik in plaats daarvan de Resize API. De lengte om de langste zijde van de bounding box van het model naar te schalen, in meters. Stuur maximaal één van resize_height, resize_longest_side en auto_size.

Gebruik in plaats daarvan de Resize API. Of de werkelijke hoogte van het object moet worden geschat met AI-visie en het model daarnaar moet worden geschaald. Stuur maximaal één van resize_height, resize_longest_side en auto_size.

Gebruik in plaats daarvan de Resize API. Waar de oorsprong van het model moet worden geplaatst, bottom of center. De standaardwaarde geldt wanneer u resize_height, resize_longest_side of auto_size meestuurt. Zonder één daarvan verplaatst Meshy de oorsprong alleen als u origin_at meestuurt.

Gebruik in plaats daarvan de Convert API. Of het model alleen naar target_formats moet worden geconverteerd. Als dit true is, negeert Meshy topology, target_polycount, decimation_mode, resize_height, resize_longest_side en auto_size, maar controleert hun waarden nog steeds, dus een ongeldige waarde geeft 400 terug. Met convert_format_only: true geeft een lege of null target_formats 400 terug.

Of er ook een voorbeeld met een transparante achtergrond (RGBA) moet worden gerenderd, dat wordt teruggegeven in alpha_thumbnail_url wanneer u de taak ophaalt. thumbnail_url verandert niet.

Het verzoek kan niet worden uitgevoerd. Het foutbericht geeft aan welk probleem er is gevonden. Bijvoorbeeld:

• Ontbrekende parameter: Noch model_url noch input_task_id is meegestuurd.
• Ongeldige invoertaak: input_task_id is geen geslaagde API-taak, of het AI-model ondersteunt geen remeshen.
• Ongeldige modelindeling: Het model_url-bestand heeft een niet-ondersteunde extensie.
• Onbereikbare URL: Meshy kan het model_url-bestand niet downloaden.
• Modelbestand te groot: Het model_url-bestand is groter dan 400 MB vanaf een http- of https-URL, of groter dan 100 MB als data-URI.
• Te veel vlakken: Het model_url-bestand is groter dan 100 MB en heeft meer dan 10.000.000 vlakken. Verminder het aantal vlakken en stuur het bestand opnieuw.
• ASCII FBX groter dan 100 MB: Het model_url-bestand is een ASCII FBX groter dan 100 MB. Stuur het als binaire FBX of GLB.
• Onleesbaar modelbestand: Het model_url-bestand is groter dan 100 MB, en Meshy kan de header niet lezen. Bijvoorbeeld een met Draco gecomprimeerde GLB of glTF, of een binaire FBX ouder dan 7.1.
• Modelheader te complex: Het model_url-bestand 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 stuur het opnieuw.
• Ongeldige topology: topology is niet quad of triangle.
• Elkaar uitsluitende parameters: Het verzoek bevat meer dan één van auto_size, resize_height en resize_longest_side. Stuur er slechts één.

Corrigeer het verzoek en stuur het opnieuw. Zie Fouten.

De API-sleutel ontbreekt of is ongeldig. Controleer de Authorization-header.

Bijvoorbeeld:

• Onvoldoende credits: Het account heeft niet genoeg credits voor deze taak, of het account heeft een creditlimiet bereikt. Controleer uw creditsaldo en probeer het opnieuw.
• Gratis abonnement: Voor het aanmaken van een taak is een betaald abonnement vereist. Upgrade uw abonnement in uw abonnementsinstellingen en probeer het opnieuw.

input_task_id is een basreliëfmodel, dat deze endpoint niet kan remeshen. Het bericht is This model type does not support this operation. Stuur een ander model.

input_task_id komt niet overeen met een van uw taken. Controleer de taak-ID en stuur het verzoek opnieuw.

U heeft uw rate limit overschreden. Wacht en probeer het opnieuw. Zie Rate limits.

De taak-ID uit de aanmaakrespons.

De ID van de te verwijderen taak.

Het paginanummer dat wordt geretourneerd, tot 255. Een hogere waarde geeft 400 terug.

Het aantal taken per pagina, tot 100.

De sorteervolgorde.

Beschikbare waarden:

• +created_at: oudste eerst
• -created_at: nieuwste eerst

De taak-ID uit de create-respons.

De taak-ID. Behandel dit als een ondoorzichtige string en vertrouw niet op het formaat ervan.

Het taaktype, altijd remesh.

Downloadlinks voor het geremeshte model, één per bestandsformaat. Een formaat dat de taak niet heeft gegenereerd, heeft geen sleutel, in plaats van een lege string.

Downloadlink voor een voorbeeldafbeelding van het geremeshte model.

Downloadlink voor een versie van thumbnail_url met een transparante achtergrond (RGBA). Alleen aanwezig wanneer je de taak hebt aangemaakt met alpha_thumbnail: true en Meshy het transparante voorbeeld heeft gerenderd.

Hoeveel van de taak is voltooid, als een percentage. Dit is 0 totdat de taak start en 100 wanneer deze slaagt.

De taakstatus, één van PENDING, IN_PROGRESS, SUCCEEDED, FAILED, of CANCELED.

Het aantal taken dat voor deze in de wachtrij staat. De waarde is alleen betekenisvol zolang de taak PENDING is.

Tijdstip waarop de taak werd aangemaakt, in Unix-milliseconden.

Tijdstip waarop de taak is gestart, in Unix-milliseconden. Dit is 0 totdat de taak start.

Tijdstip waarop de taak is beëindigd, in Unix-milliseconden. Dit is 0 totdat de taak beëindigd is.

Tijdstip waarop de downloadlinks van de taak verlopen, in Unix-milliseconden. Dit is 0 totdat de taak beëindigd is.

Downloadlinks voor de textuurmaps van het model, wanneer de taak slaagt: een array van objecten, één per textuurset. Elk object heeft een base_color-URL, en kan ook metallic-, roughness-, normal-, emission- en metallic_roughness-URL's hebben. Dit is null totdat de taak slaagt, en een lege array wanneer het model geen textuurmaps heeft.

De foutdetails wanneer de taak mislukt. Zie Fouten.

Het aantal credits dat de taak heeft gebruikt. Aanwezig wanneer de status PENDING, IN_PROGRESS, of SUCCEEDED is. Dit is 0 voor een FAILED-taak, omdat Meshy de credits terugbetaalt wanneer een taak mislukt.