API de Rigging
Ajoutez un squelette (armature) à un modèle 3D humanoïde ou à quatre pattes et liez le maillage à celui-ci, afin que le personnage soit prêt à être animé. Pour appliquer des animations à un personnage riggé, consultez l'API Animation.
Le rigging fonctionne bien avec les personnages humanoïdes standards (bipèdes) qui ont une structure de membres et de corps clairement définie, ainsi qu'avec les animaux à quatre pattes. Pour riguer un animal, consultez Riguer un animal à quatre pattes.
Créer une tâche de Rigging
Crée une tâche de Rigging pour un modèle 3D. Lorsque la tâche réussit, elle renvoie un personnage riggé dans des formats standards et, en option, des animations de marche et de course de base.
La tâche s'exécute en arrière-plan. Pour connaître la durée habituelle d'une tâche, consultez Temps de traitement.
Le Rigging ne convient pas à ces modèles :
- Maillages non texturés
- Assets qui ne sont ni des humanoïdes ni des animaux quadrupèdes
- Assets humanoïdes avec une structure des membres et du corps peu claire
Request
# Rig a model from a URL
curl https://api.meshy.ai/openapi/v1/rigging \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "YOUR_MODEL_URL_OR_DATA_URI",
"height_meters": 1.8
}'
Response
{
"result": "018b314a-a1b5-716d-c222-2f1776f7f579"
}
Paramètres
- Name
- input_task_id
- Type
- string
- Requis
- Description
Obligatoire sauf si vous envoyez
model_url. L'ID de la tâche dont vous voulez rigger le modèle. Meshy prend en charge les modèles humanoïdes texturés et les animaux quadrupèdes.Le modèle peut avoir au maximum 380 000 triangles (un quad compte pour 2), et un modèle qui en a plus renvoie
400. Pour rester sous cette limite, exécutez d'abord l'API Remesh dessus avec untarget_polycountde300000ou moins, ou de150000ou moins avectopology: quad.
- Name
- model_url
- Type
- string
- Requis
- Description
Obligatoire sauf si vous envoyez
input_task_id. Le modèle à rigger, sous forme d'URL publique ou de Data URI. Si vous envoyez les deux, Meshy utiliseinput_task_id.Le modèle doit être un fichier GLB (
.glb) d'au maximum 400 Mo provenant d'une URLhttpouhttps, ou de 100 Mo en tant que Data URI. Le Rigging prend en charge les modèles humanoïdes texturés et les animaux quadrupèdes.Le modèle peut avoir au maximum 380 000 triangles (un quad compte pour 2), et un modèle qui en a plus renvoie
400. Pour rester sous cette limite, exécutez d'abord l'API Remesh dessus avec untarget_polycountde300000ou moins, ou de150000ou moins avectopology: quad.Le visage du personnage doit être orienté vers l'axe +Z, la direction avant standard de glTF. L'estimation de pose échoue pour un modèle orienté vers un autre axe.
Un fichier de plus de 100 Mo doit également respecter ces règles :
- Il peut avoir au maximum 10 000 000 faces. Un fichier qui en a plus renvoie
400. Meshy compte les faces comme des triangles, et un maillage dessiné plusieurs fois compte une fois par copie. - Il ne doit pas utiliser la compression Draco.
- Il peut avoir au maximum 10 000 000 faces. Un fichier qui en a plus renvoie
- Name
- animation_type
- Type
- string
- défaut biped
- Description
Le type de personnage à rigger. Toute autre valeur renvoie
400.Valeurs disponibles :
biped: un personnage humanoïdequadruped: un animal à quatre pattes. Voir Rigger un animal quadrupède.
- Name
- height_meters
- Type
- number
- défaut 1.7 (biped)
- Description
La hauteur du modèle en mètres. Meshy met le modèle riggé à l'échelle de cette hauteur. Une valeur négative renvoie
400.- Rig biped : la valeur par défaut est
1.7. - Rig quadruped : sans ce paramètre, ou avec
0, l'animal conserve sa propre taille.
- Rig biped : la valeur par défaut est
- Name
- texture_image_url
- Type
- string
- ⚠ obsolète
- Description
Ne l'envoyez pas lorsque le modèle possède ses propres textures. Sans ce paramètre, Meshy utilise les textures intégrées au fichier
model_url, ou les textures de la tâche d'entrée. Si vous l'envoyez, cette image devient l'unique texture du modèle riggé, et le modèle perd ses cartes PBR.La texture de couleur de base dépliée en UV du modèle, sous forme d'URL publique ou de Data URI. L'image doit être un fichier PNG d'au maximum 20 Mo. Un autre format d'image renvoie
400.
- Name
- skeleton_template
- Type
- string
- défaut meshyrig
- Description
Le squelette du personnage riggé, qui définit les noms de ses os et leur hiérarchie. Choisissez celui attendu par votre moteur ou votre outil.
Valeurs disponibles :
meshyrig: le squelette propre à Meshymixamo: Mixamoue5_mannequin: Unreal Engine 5 Mannequinmax_biped: 3ds Max Bipedunity_humanoid: Unity Humanoidmaya_human_ik: Maya HumanIKblender_rigify_basic_human: Blender Rigify basic humancc5_hd_neutral_base: Character Creator 5 HD neutral basedaz_genesis9: DAZ Genesis 9
Toute autre valeur renvoie
400. Fonctionne uniquement avec un rig biped.Avec une valeur autre que
meshyrig, ou avecinclude_fingersdéfini surtrue, les fichiers sont en mètres et utilisent les os de ce squelette, au lieu des fichiersmeshyrigpar défaut à 24 os en centimètres. Un modèle que Meshy ne peut pas rigger sur ce squelette fait échouer la tâche. Réessayez avecmeshyrigetinclude_fingersdéfini surfalse, ou avec une autre valeur.Les clips d'animation de la bibliothèque dans ces fichiers portent les mêmes noms que dans les fichiers
meshyrigpar défaut, commeArmature|walking_man|baselayer. Un clip Text to Motion est nomméretarget_clipsur chaque rig. Le fichier FBX inclut des os terminaux. Quelques os terminaux, commeheadfront, conservent leur nom d'origine.Les tâches d'Animation créées à partir de ce rig utilisent le même squelette.
- Name
- include_fingers
- Type
- boolean
- défaut false
- Description
S'il faut ajouter des os de doigts aux mains du personnage. Fonctionne uniquement avec un rig biped. Avec
meshyrig, les os de doigts utilisent les noms Mixamo, commeLeftHandThumb1.Avec
true, ces requêtes renvoient une erreur, et Meshy ne les facture pas :- Un rig quadruped,
texture_image_url, ou uninput_task_iddont le modèle a une topologie quad renvoie400. - Un modèle que Meshy ne peut rigger que sans os de doigts renvoie
422. - Si Meshy ne peut pas rigger les mains du personnage avec des doigts, la tâche échoue. Réessayez, ou définissez
include_fingerssurfalse.
Meshy détecte les doigts automatiquement et fonctionne mieux sur des mains dont les doigts sont clairement séparés. Sur des mains modélisées comme une seule forme, comme des moufles, des gants ou des mains stylisées, le rig peut avoir moins d'os de doigts et animer la main comme une seule pièce. Le reste du squelette est identique dans les deux cas. Le squelette peut aussi inclure des os supplémentaires, par exemple pour les cheveux ou les vêtements. Les os de doigts ne modifient pas le coût en crédits.
- Un rig quadruped,
Retours
Le champ result de la réponse contient l'ID de la nouvelle tâche de Rigging.
Modes d'échec
- Name
400 - Bad Request- Description
La requête ne peut pas s'exécuter. Le message d'erreur indique le problème trouvé. Par exemple :
- Paramètre manquant : Ni
model_urlniinput_task_idn'a été envoyé. - Format de modèle invalide : Le fichier
model_urla une extension non prise en charge. Seul.glbest pris en charge. - URL inaccessible : Meshy ne peut pas télécharger le fichier
model_url. - Fichier de modèle trop volumineux : Le fichier
model_urldépasse 400 Mo depuis une URLhttpouhttps, ou dépasse 100 Mo en tant que Data URI. - Trop de faces : Le fichier
model_urldépasse 100 Mo et a plus de 10 000 000 faces. Réduisez le nombre de faces, puis renvoyez le fichier. - Fichier de modèle illisible : Le fichier
model_urldépasse 100 Mo, et Meshy ne peut pas lire son en-tête. Par exemple, il s'agit d'un fichier GLB compressé avec Draco. - En-tête de modèle trop complexe : Le fichier
model_urldépasse 100 Mo, et son en-tête contient trop de maillages, de nœuds ou d'enregistrements à vérifier. Réduisez le nombre d'objets dans le fichier, puis renvoyez-le. - Image trop volumineuse : L'image
texture_image_urldépasse 20 Mo. - Format de texture invalide : L'image
texture_image_urln'est pas un fichier PNG. - Hauteur invalide :
height_metersest négatif. - Modèle de squelette invalide :
skeleton_templaten'est pas l'une des valeurs disponibles, ou a été envoyé avec un rig quadruped. - Os de doigts non pris en charge :
include_fingersvauttrueavec un rig quadruped,texture_image_url, ou uninput_task_iddont le modèle a une topologie quad. - Tâche d'entrée invalide :
input_task_idne fait pas référence à une tâche API valide. - Tâche d'entrée non prête : La tâche
input_task_idn'a pas atteint l'étatSUCCEEDED. Attendez qu'elle réussisse, puis réessayez. - Nombre de faces dépassé : Le modèle d'entrée a plus de 380 000 triangles (un quad compte pour 2). Exécutez l'API Remesh dessus avec un
target_polycountde300000ou moins, ou de150000ou moins avectopology: quad, avant de rigger le modèle.
Corrigez la requête, puis renvoyez-la. Voir Erreurs.
- Paramètre manquant : Ni
- Name
401 - Unauthorized- Description
La clé API est manquante ou invalide. Vérifiez l'en-tête
Authorization.
- Name
402 - Payment Required- Description
Par exemple :
- Crédits insuffisants : Le compte n'a pas assez de crédits pour cette tâche, ou le compte a atteint une limite de crédits. Vérifiez votre solde de crédits, puis réessayez.
- Plan gratuit : La création d'une tâche nécessite un plan payant. Mettez à niveau votre plan dans vos paramètres d'abonnement, puis réessayez.
- Name
403 - Forbidden- Description
input_task_idest un modèle bas-relief, que ce point de terminaison ne peut pas rigger. Le message estThis model type does not support this operation. Envoyez un modèle différent.
- Name
404 - Not Found- Description
Meshy ne trouve pas les fichiers de la tâche
input_task_id. L'un de ces cas s'applique :- Meshy a supprimé les fichiers de la tâche après son
expires_at. Recréez la tâche, puis envoyez l'ID de cette nouvelle tâche. - La tâche ne dispose d'aucun des fichiers nécessaires au Rigging, comme une image de prévisualisation, par exemple une tâche Convert. Riggez la tâche d'origine, ou envoyez le modèle en tant que
model_url.
- Meshy a supprimé les fichiers de la tâche après son
- Name
422 - Unprocessable Entity- Description
Par exemple :
- Échec de l'estimation de pose : Le modèle n'est peut-être pas un personnage humanoïde valide. Envoyez un modèle de personnage humanoïde. Pour
model_url, vérifiez aussi que le personnage est orienté vers l'axe +Z. - Modèle de squelette indisponible : Meshy ne peut rigger ce modèle que sur le squelette
meshyrig. Omettezskeleton_template, ou définissez-le surmeshyrig. Meshy ne facture pas la requête. - Os de doigts indisponibles : Meshy ne peut rigger ce modèle que sur
meshyrigsans os de doigts. Omettezinclude_fingersetskeleton_template. Meshy ne facture pas la requête.
- Échec de l'estimation de pose : Le modèle n'est peut-être pas un personnage humanoïde valide. Envoyez un modèle de personnage humanoïde. Pour
- Name
429 - Too Many Requests- Description
Vous avez dépassé votre limite de débit. Attendez, puis réessayez. Voir Limites de débit.
- Name
503 - Service Unavailable- Description
Meshy n'a pas pu terminer l'analyse de la pose du modèle. Réessayez la requête.
Rigger un animal à quatre pattes
Pour rigger un animal à quatre pattes, envoyez animation_type défini sur quadruped.
Un rig quadrupède diffère d'un rig bipède sur les points suivants :
basic_animationscontient une animation de marche et une animation de course de l'animal. Si Meshy ne peut pas en créer une, ses URLs sont des chaînes vides, et la tâche réussit tout de même.walking_armature_glb_urletrunning_armature_glb_urlsont le squelette du rig, sans animation.height_metersn'a pas pour valeur par défaut1.7. Voir Créer une tâche de rigging.- Envoyer
skeleton_template, ouinclude_fingersdéfini surtrue, renvoie400. - Si Meshy ne peut pas rigger le modèle en tant qu'animal à quatre pattes, la tâche échoue.
Un rig quadrupède coûte le même prix qu'un rig bipède. Voir Tarification.
Pour animer l'animal riggé, appliquez des animations de la bibliothèque dont le rig_type est quadruped, en tant que action_id ou action_ids. Voir Animation.
Request
# Rig a four-legged animal
curl https://api.meshy.ai/openapi/v1/rigging \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"model_url": "YOUR_MODEL_URL_OR_DATA_URI",
"animation_type": "quadruped"
}'
Récupérer une tâche de rigging
Renvoie une tâche de rigging par son ID.
Request
curl https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
{
"id": "018b314a-a1b5-716d-c222-2f1776f7f579",
"type": "rig",
"status": "SUCCEEDED",
"created_at": 1747032400453,
"progress": 100,
"started_at": 1747032401314,
"finished_at": 1747032418417,
"expires_at": 1747291618417,
"task_error": null,
"consumed_credits": 5,
"result": {
"rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
"rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
"basic_animations": {
"walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
"walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
"walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
"running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
"running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
"running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
}
}
}
Paramètres
- Name
- id
- Type
- path
- Description
L'ID de la tâche provenant de la réponse de création.
Retourne
Supprimer une tâche de Rigging
Supprime définitivement une tâche de Rigging, y compris ses modèles et ses données. Vous ne pouvez pas annuler une suppression.
Request
curl --request DELETE \
--url https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
"message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}
Paramètres de chemin
- Name
- id
- Type
- path
- Description
L'ID de la tâche à supprimer.
Statut de la tâche
La suppression d'une tâche PENDING rembourse les crédits utilisés lors de sa création.
Une tâche IN_PROGRESS ne peut pas être supprimée. La requête renvoie 409 Conflict,
et la tâche continue de s'exécuter. Meshy ne rembourse pas une tâche qui a démarré,
donc la supprimer vous ferait perdre à la fois les crédits et le résultat. Attendez
qu'elle atteigne le statut SUCCEEDED, FAILED ou CANCELED, puis supprimez-la.
La suppression d'une tâche dans un statut final (SUCCEEDED, FAILED ou CANCELED)
ne rembourse pas ses crédits.
Retours
200 OK lorsque la tâche est supprimée, ou 409 Conflict lorsque la tâche est
IN_PROGRESS.
Lister les tâches de Rigging
Renvoie une liste paginée de vos tâches de Rigging, les plus récentes en premier. Pour parcourir la liste, utilisez page_num et page_size.
Les tâches que vous créez avec l'API restent dans l'API et n'apparaissent pas dans Mes assets dans l'application web. Pour retrouver une tâche dont vous n'avez plus l'ID, utilisez ce point de terminaison.
Request
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Diffuser une tâche de Rigging en flux
Diffuse les mises à jour d'une tâche de Rigging sous forme d'événements envoyés par le serveur (SSE).
Request
curl -N https://api.meshy.ai/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response Stream
// Error event example
event: error
data: {
"status_code": 404,
"message": "Task not found"
}
// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
"id": "018b314a-a1b5-716d-c222-2f1776f7f579",
"progress": 0,
"status": "PENDING"
}
event: message
data: {
"id": "018b314a-a1b5-716d-c222-2f1776f7f579",
"progress": 50,
"status": "IN_PROGRESS"
}
event: message
data: { // Example of a SUCCEEDED task event, with the same fields as the Rigging task object
"id": "018b314a-a1b5-716d-c222-2f1776f7f579",
"type": "rig",
"status": "SUCCEEDED",
"created_at": 1747032400453,
"progress": 100,
"started_at": 1747032401314,
"finished_at": 1747032418417,
"expires_at": 1747291618417,
"task_error": null,
"consumed_credits": 5,
"result": {
"rigged_character_fbx_url": "https://assets.meshy.ai/.../Character_output.fbx?...",
"rigged_character_glb_url": "https://assets.meshy.ai/.../Character_output.glb?...",
"basic_animations": {
"walking_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.glb?...",
"walking_fbx_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin.fbx?...",
"walking_armature_glb_url": "https://assets.meshy.ai/.../Animation_Walking_withSkin_armature.glb?...",
"running_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.glb?...",
"running_fbx_url": "https://assets.meshy.ai/.../Animation_Running_withSkin.fbx?...",
"running_armature_glb_url": "https://assets.meshy.ai/.../Animation_Running_withSkin_armature.glb?..."
}
}
}
Paramètres
- Name
- id
- Type
- path
- Description
L'ID de la tâche provenant de la réponse de création.
Retours
Un flux d'objets de tâche de Rigging sous forme d'événements envoyés par le serveur.
Chaque événement contient l'objet de tâche complet, sous la même forme que celle renvoyée par le point de terminaison Get. Tant que la tâche est PENDING ou IN_PROGRESS, ses champs de résultat n'ont pas encore de valeurs.
L'objet de tâche de rigging
Un objet de tâche de rigging décrit le rigging d'un personnage. Il contient le statut, le progress et les fichiers de sortie lorsque la tâche réussit.
Propriétés
Example Rigging Task Object
{
"id": "018b314a-a1b5-716d-c222-2f1776f7f579",
"type": "rig",
"status": "SUCCEEDED",
"created_at": 1747032400453,
"progress": 100,
"started_at": 1747032401314,
"finished_at": 1747032418417,
"expires_at": 1747291618417,
"task_error": null,
"consumed_credits": 5,
"result": {
"rigged_character_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.fbx?Expires=...",
"rigged_character_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Character_output.glb?Expires=...",
"basic_animations": {
"walking_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.glb?Expires=...",
"walking_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin.fbx?Expires=...",
"walking_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Walking_withSkin_armature.glb?Expires=...",
"running_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.glb?Expires=...",
"running_fbx_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin.fbx?Expires=...",
"running_armature_glb_url": "https://assets.meshy.ai/0630d47c-84b8-4d37-bc02-69e45d9272c1/tasks/018b314a-a1b5-716d-c222-2f1776f7f579/output/Animation_Running_withSkin_armature.glb?Expires=..."
}
}
}
- Name
- id
- Type
- string
- Description
L'ID de la tâche. Traitez-le comme une chaîne opaque, et ne vous fiez pas à son format.
- Name
- type
- Type
- string
- Description
Le type de tâche, toujours
rig.
- Name
- status
- Type
- string
- Description
Le statut de la tâche, l'un des suivants :
PENDING,IN_PROGRESS,SUCCEEDED,FAILED, ouCANCELED.
- Name
- progress
- Type
- integer
- Description
Le pourcentage d'avancement de la tâche. Il est à
0jusqu'à ce que la tâche démarre et à100lorsqu'elle réussit.
- Name
- created_at
- Type
- timestamp
- Description
Heure de création de la tâche, en millisecondes Unix.
- Name
- started_at
- Type
- timestamp
- Description
Heure de démarrage de la tâche, en millisecondes Unix. Elle est à
0jusqu'à ce que la tâche démarre.
- Name
- finished_at
- Type
- timestamp
- Description
Heure de fin de la tâche, en millisecondes Unix. Elle est à
0jusqu'à ce que la tâche se termine.
- Name
- expires_at
- Type
- timestamp
- Description
Heure d'expiration des fichiers de résultat de la tâche, en millisecondes Unix. Après cette heure, Meshy peut supprimer les fichiers.
- Name
- task_error
- Type
- object
- Description
Les détails de l'erreur lorsque la tâche échoue. Il est
nullsauf si le statut estFAILED. Voir Erreurs.
- Name
- consumed_credits
- Type
- integer
- Description
Le nombre de crédits utilisés par la tâche. Présent lorsque le statut est
PENDING,IN_PROGRESS, ouSUCCEEDED. Il est à0pour une tâcheFAILED, car Meshy rembourse les crédits lorsqu'une tâche échoue.
- Name
- result
- Type
- object
- Description
Les URL des fichiers de sortie. Tant que la tâche n'a pas réussi, chaque URL est une chaîne vide, et
basic_animationsestnull.- Name
rigged_character_fbx_url- Type
- string
- Description
URL de téléchargement du personnage riggé au format FBX.
- Name
rigged_character_glb_url- Type
- string
- Description
URL de téléchargement du personnage riggé au format GLB.
- Name
basic_animations- Type
- object (optional)
- Description
URL de téléchargement des animations de marche et de course par défaut.
- Name
walking_glb_url- Type
- string
- Description
- L'animation de marche avec peau, au format GLB.
- Name
walking_fbx_url- Type
- string
- Description
- L'animation de marche avec peau, au format FBX.
- Name
walking_armature_glb_url- Type
- string
- Description
- L'armature de l'animation de marche, au format GLB.
- Name
running_glb_url- Type
- string
- Description
- L'animation de course avec peau, au format GLB.
- Name
running_fbx_url- Type
- string
- Description
- L'animation de course avec peau, au format FBX.
- Name
running_armature_glb_url- Type
- string
- Description
- L'armature de l'animation de course, au format GLB.
- Name
- preceding_tasks
- Type
- integer
- Description
Le nombre de tâches qui précèdent celle-ci dans la file d'attente. La valeur n'est significative que lorsque la tâche est
PENDING. Le champ est omis lorsque la valeur est0.