Rigging API

Vereist, tenzij u model_url verstuurt. De ID van de taak waarvan u het model wilt riggen. Meshy ondersteunt geteksturede humanoïde modellen.

Het model mag maximaal 380.000 driehoeken bevatten (een vierhoek telt als 2), en een model met meer driehoeken geeft 400 terug. Om onder de limiet te blijven, voert u eerst de Remesh API erop uit met een target_polycount van 300000 of minder, of 150000 of minder met topology: quad.

Vereist, tenzij u input_task_id verstuurt. Het te riggen model, als een openbare URL of een data-URI. Als u beide verstuurt, gebruikt Meshy input_task_id.

Het model moet een GLB-bestand (.glb) zijn van maximaal 400 MB vanaf een http- of https-URL, of 100 MB als data-URI. Rigging ondersteunt geteksturede humanoïde modellen.

Het model mag maximaal 380.000 driehoeken bevatten (een vierhoek telt als 2), en een model met meer driehoeken geeft 400 terug. Om onder de limiet te blijven, voert u eerst de Remesh API erop uit met een target_polycount van 300000 of minder, of 150000 of minder met topology: quad.

Het gezicht van het personage moet naar de +Z-as wijzen, de standaard voorwaartse richting van glTF. Poseschatting mislukt voor een model dat naar een andere as wijst.

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

• Het mag maximaal 10.000.000 vlakken bevatten. Een bestand met meer vlakken geeft 400 terug. Meshy telt vlakken als driehoeken, en een mesh die meer dan eens wordt getekend telt per kopie.
• Het mag geen Draco-compressie gebruiken.

De geschatte lengte van het personage, in meters. Meshy gebruikt dit om het model nauwkeuriger te schalen en te riggen. Een negatieve waarde geeft 400 terug.

Laat dit weg wanneer het model zijn eigen textures heeft. Zonder dit gebruikt Meshy de textures die in het model_url-bestand zijn ingesloten, of de textures van de invoertaak. Als u dit verstuurt, wordt deze afbeelding de enige textuur van het gerigde model, en verliest het model zijn PBR-maps.

De UV-uitgevouwen basiskleurtextuur van het model, als een openbare URL of een data-URI. De afbeelding moet een PNG-bestand van maximaal 20 MB zijn. Een ander afbeeldingsformaat geeft 400 terug.

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

• Ontbrekende parameter: Noch model_url noch input_task_id is verstuurd.
• Ongeldig modelformaat: Het model_url-bestand heeft een niet-ondersteunde extensie. Alleen .glb wordt ondersteund.
• 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 verstuur het bestand opnieuw.
• Onleesbaar modelbestand: Het model_url-bestand is groter dan 100 MB, en Meshy kan de header niet lezen. Het is bijvoorbeeld een Draco-gecomprimeerde GLB.
• 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 verstuur het opnieuw.
• Afbeelding te groot: De afbeelding bij texture_image_url is groter dan 20 MB.
• Ongeldig textuurformaat: De afbeelding bij texture_image_url is geen PNG-bestand.
• Ongeldige hoogte: height_meters is negatief.
• Ongeldige invoertaak: input_task_id verwijst niet naar een geldige API-taak.
• Invoertaak nog niet gereed: De taak bij input_task_id heeft SUCCEEDED nog niet bereikt. Wacht tot deze slaagt en probeer het opnieuw.
• Maximum aantal vlakken overschreden: Het invoermodel heeft meer dan 380.000 driehoeken (een vierhoek telt als 2). Voer de Remesh API erop uit met een target_polycount van 300000 of minder, of 150000 of minder met topology: quad, voordat u het model rigt.

Corrigeer het verzoek en verstuur 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 plan: Het maken van een taak vereist een betaald plan. Upgrade uw plan in uw abonnementsinstellingen en probeer het opnieuw.

input_task_id is een bas-reliëfmodel, dat deze endpoint niet kan riggen. Het bericht is This model type does not support this operation. Verstuur een ander model.

Meshy kan de bestanden van de taak bij input_task_id niet vinden. Een van het volgende is van toepassing:

• Meshy heeft de bestanden van de taak verwijderd na de expires_at. Maak de taak opnieuw aan en verstuur de ID van die taak.
• De taak heeft geen van de bestanden die rigging nodig heeft, zoals een voorvertoningsafbeelding, bijvoorbeeld een Convert-taak. Rig de taak waar deze vandaan komt, of verstuur het model als model_url.

Poseschatting is mislukt. Het model is mogelijk geen geldig humanoïde personage. Verstuur een model van een humanoïde personage. Controleer bij model_url ook of het personage naar de +Z-as wijst.

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

De taak-ID uit het aanmaakverzoek-antwoord.

De ID van de te verwijderen taak.

De taak-ID uit de aanmaakrespons.

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

Het taaktype, altijd rig.

De taakstatus, een van PENDING, IN_PROGRESS, SUCCEEDED, FAILED of CANCELED.

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

Tijdstip waarop de taak is 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 eindigt.

Tijdstip waarop de resultaatbestanden van de taak verlopen, in Unix-milliseconden. Na dit tijdstip kan Meshy de bestanden verwijderen.

De foutdetails wanneer de taak mislukt. Dit is null tenzij de status FAILED is. 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.

De URL's van de uitvoerbestanden. Totdat de taak slaagt, is elke URL een lege tekenreeks en is basic_animations null.

Het aantal taken dat vóór deze taak in de wachtrij staat. De waarde is alleen zinvol zolang de taak PENDING is. Het veld wordt weggelaten wanneer de waarde 0 is.