Animatie-API

De ID van de Rigging-taak waarvan het personage geanimeerd moet worden, afkomstig van POST /openapi/v1/rigging. De taak moet de status SUCCEEDED hebben.

Vereist tenzij u action_ids of motion_task_id stuurt. De ID van de vooraf ingestelde animatie die moet worden toegepast. Voor de volledige lijst met animaties, zie de Animatiebibliotheek-referentie of Animaties weergeven.

Vereist tenzij u action_id of motion_task_id stuurt. De ID's van 1 tot 10 vooraf ingestelde animaties die tegelijk moeten worden toegepast, zonder herhalingen. Meer dan 10 ID's, of een herhaalde ID, geeft 400 terug. Voor de ID's, zie de Animatiebibliotheek-referentie.

Meshy geeft één bestand terug met één animatieclip per actie, wat geschikt is voor een state machine in een game-engine. Meshy rekent kosten voor elke actie in de lijst. Zie Prijzen.

Een lijst met één ID werkt hetzelfde als het sturen van die ID als action_id.

Vereist tenzij u action_id of action_ids stuurt. De ID van een Text to Motion-taak waarvan de clip moet worden toegepast in plaats van een vooraf ingestelde actie. De taak moet de status SUCCEEDED hebben, en de rig moet een tweevoeter zijn.

Meshy retarget de clip naar het gerigde personage. Het kopieert de clip wanneer u deze taak aanmaakt, dus deze taak wordt niet beïnvloed als de Text to Motion-taak later verloopt of u deze verwijdert. Meshy bewaart de bestanden van de Text to Motion-taak gedurende 3 dagen, dus pas de clip vóór die tijd toe.

Nabewerking voor de animatie-uitvoer. Laat dit weg om de standaard animatiebestanden te krijgen.

Met motion_task_id kan de retarget een GLB-only animatie opleveren. Als u post_process stuurt en er is geen FBX-bestand beschikbaar, mislukt de taak met een task_error, en Meshy vergoedt uw credits. Zonder post_process slaagt de taak, en is animation_fbx_url leeg.

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

• Ontbrekende parameter: rig_task_id ontbreekt, of geen van action_id, action_ids en motion_task_id werd verzonden.
• Conflicterende parameters: Het verzoek bevat meer dan één van action_id, action_ids en motion_task_id. Stuur er slechts één.
• Ongeldige rig-taak: rig_task_id is geen geldige taak-ID, is geen Rigging-taak, of verwijst naar een taak die niet is geslaagd.
• Ongeldige actie-ID: Een action_id, of een item in action_ids, is geen geldige animatie.
• Te veel acties: action_ids heeft meer dan 10 ID's.
• Dubbele acties: action_ids bevat dezelfde ID meer dan eens.
• Motion-taak niet gereed: De taak van motion_task_id heeft nog niet de status SUCCEEDED bereikt.
• Niet-ondersteunde rig: motion_task_id vereist een tweevoeter-rig, en Meshy wijst een viervoeter-rig af.

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: Het aanmaken van een taak vereist een betaald abonnement. Upgrade uw abonnement in uw abonnementsinstellingen en probeer het opnieuw.

De taak van rig_task_id is een bas-reliëfmodel, dat dit endpoint niet kan animeren. Het bericht is This model type does not support this operation. Rig een ander model.

Meshy kan een taak of bestand dat het verzoek nodig heeft, niet vinden. Een van het volgende is van toepassing:

• Meshy kan de taak van rig_task_id niet vinden onder uw taken. Controleer de ID.
• Meshy heeft de bestanden van de taak van rig_task_id verwijderd na de expires_at. Rig het personage opnieuw.
• Meshy kan de taak van motion_task_id niet vinden. Controleer de ID.
• De motion-clip is verlopen, omdat Meshy de bestanden van een Text to Motion-taak gedurende 3 dagen bewaart. Maak een nieuwe Text to Motion-taak aan.

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

De taak-ID uit de respons bij het aanmaken.

De ID van de te verwijderen taak.

De taak-ID uit de respons bij het aanmaken.

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

Het taaktype, altijd animate.

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

Hoeveel van de taak is voltooid, als percentage. Dit is 0 tot 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 tot de taak begint.

Tijdstip waarop de taak is voltooid, in Unix-milliseconden. Dit is 0 tot de taak is voltooid.

Tijdstip waarop de resultaatbestanden van de taak verlopen, in Unix-milliseconden.

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.

Download-URL's voor de animatiebestanden, wanneer de taak de status SUCCEEDED heeft.

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

Tekst om naar te zoeken. Meshy geeft de animaties terug waarvan name of key deze tekst bevat, ongeacht hoofdlettergebruik. Meshy matcht de tekst letterlijk, dus % en _ zijn geen jokertekens.

De categorie om weer te geven, als exacte overeenkomst. Een onbekende categorie geeft een lege lijst terug.

Beschikbare waarden:

• WalkAndRun
• BodyMovements
• DailyActions
• Fighting
• Dancing

De subcategorie om weer te geven, als exacte overeenkomst. Je kunt deze zonder category versturen. Subcategorienamen zijn niet uniek binnen categorieën. Transitioning valt bijvoorbeeld zowel onder Fighting als onder DailyActions. Dus zonder category matcht het filter de subcategorie in elke categorie.

De animaties om terug te geven, als maximaal 200 door komma's gescheiden action_id-waarden. Gebruik dit om specifieke ID's op te zoeken in plaats van te bladeren. Meer dan 200 ID's geeft 400 terug.

De respons laat een ID weg die geen enkele animatie heeft. Je kunt dit filter dus ook gebruiken om te controleren of door jou opgeslagen ID's nog beschikbaar zijn.

De waarde die u als action_id meestuurt wanneer u een Animatie-taak aanmaakt. Deze is uniek en stabiel, maar niet doorlopend. Uitgefaseerde animaties laten gaten achter in de nummering, dus ga er niet van uit dat elk ID binnen een bereik geldig is.

De weergavenaam van de animatie. Deze is niet uniek, omdat sommige animaties een naam delen met een andere variant. Gebruik action_id of key om een animatie te identificeren.

Een unieke, stabiele slug voor de animatie. Gebruik deze wanneer u een niet-numeriek ID nodig heeft om uw eigen opslag op te baseren.

De groep op het hoogste niveau, bijvoorbeeld Fighting.

De groep binnen de categorie, bijvoorbeeld AttackingwithWeapon.

URL van een geanimeerde GIF-voorvertoning van de actie. U kunt deze direct tonen in uw eigen kiezer.