lowpoly sera retiré le 30 oct. 2026. meshy-7 sera retiré en tant que modèle de génération 3D le 31 déc. 2026 ; il reste disponible en tant que modèle de texture. Changez de modèle avant ces dates pour éviter les erreurs de requête. Voir toutes les dépréciations

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.


POST/openapi/v1/rigging

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

POST
/openapi/v1/rigging
# 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 un target_polycount de 300000 ou moins, ou de 150000 ou moins avec topology: 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 utilise input_task_id.

    Le modèle doit être un fichier GLB (.glb) d'au maximum 400 Mo provenant d'une URL http ou https, 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 un target_polycount de 300000 ou moins, ou de 150000 ou moins avec topology: 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.
  • Name
    animation_type
    Type
    string
    défaut biped
    Description

    Le type de personnage à rigger. Toute autre valeur renvoie 400.

    Valeurs disponibles :

  • 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.
  • 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 à Meshy
    • mixamo : Mixamo
    • ue5_mannequin : Unreal Engine 5 Mannequin
    • max_biped : 3ds Max Biped
    • unity_humanoid : Unity Humanoid
    • maya_human_ik : Maya HumanIK
    • blender_rigify_basic_human : Blender Rigify basic human
    • cc5_hd_neutral_base : Character Creator 5 HD neutral base
    • daz_genesis9 : DAZ Genesis 9

    Toute autre valeur renvoie 400. Fonctionne uniquement avec un rig biped.

    Avec une valeur autre que meshyrig, ou avec include_fingers défini sur true, les fichiers sont en mètres et utilisent les os de ce squelette, au lieu des fichiers meshyrig par 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 avec meshyrig et include_fingers défini sur false, 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 meshyrig par défaut, comme Armature|walking_man|baselayer. Un clip Text to Motion est nommé retarget_clip sur chaque rig. Le fichier FBX inclut des os terminaux. Quelques os terminaux, comme headfront, 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, comme LeftHandThumb1.

    Avec true, ces requêtes renvoient une erreur, et Meshy ne les facture pas :

    • Un rig quadruped, texture_image_url, ou un input_task_id dont le modèle a une topologie quad renvoie 400.
    • 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_fingers sur false.

    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.

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_url ni input_task_id n'a été envoyé.
    • Format de modèle invalide : Le fichier model_url a une extension non prise en charge. Seul .glb est 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_url dépasse 400 Mo depuis une URL http ou https, ou dépasse 100 Mo en tant que Data URI.
    • Trop de faces : Le fichier model_url dé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_url dé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_url dé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_url dépasse 20 Mo.
    • Format de texture invalide : L'image texture_image_url n'est pas un fichier PNG.
    • Hauteur invalide : height_meters est négatif.
    • Modèle de squelette invalide : skeleton_template n'est pas l'une des valeurs disponibles, ou a été envoyé avec un rig quadruped.
    • Os de doigts non pris en charge : include_fingers vaut true avec un rig quadruped, texture_image_url, ou un input_task_id dont le modèle a une topologie quad.
    • Tâche d'entrée invalide : input_task_id ne fait pas référence à une tâche API valide.
    • Tâche d'entrée non prête : La tâche input_task_id n'a pas atteint l'état SUCCEEDED. 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_polycount de 300000 ou moins, ou de 150000 ou moins avec topology: quad, avant de rigger le modèle.

    Corrigez la requête, puis renvoyez-la. Voir Erreurs.

  • 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_id est un modèle bas-relief, que ce point de terminaison ne peut pas rigger. Le message est This 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.
  • 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. Omettez skeleton_template, ou définissez-le sur meshyrig. Meshy ne facture pas la requête.
    • Os de doigts indisponibles : Meshy ne peut rigger ce modèle que sur meshyrig sans os de doigts. Omettez include_fingers et skeleton_template. Meshy ne facture pas la requête.
  • 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_animations contient 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_url et running_armature_glb_url sont le squelette du rig, sans animation.
  • height_meters n'a pas pour valeur par défaut 1.7. Voir Créer une tâche de rigging.
  • Envoyer skeleton_template, ou include_fingers défini sur true, renvoie 400.
  • 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

POST
/openapi/v1/rigging
# 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"
  }'

GET/openapi/v1/rigging/:id

Récupérer une tâche de rigging

Renvoie une tâche de rigging par son ID.

Request

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
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

L'objet tâche de rigging.


DELETE/openapi/v1/rigging/:id

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

DELETE
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579
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.


GET/openapi/v1/rigging

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

GET
/openapi/v1/rigging
curl "https://api.meshy.ai/openapi/v1/rigging?page_num=1&page_size=20" \
-H "Authorization: Bearer ${YOUR_API_KEY}"

GET/openapi/v1/rigging/:id/stream

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

GET
/openapi/v1/rigging/018b314a-a1b5-716d-c222-2f1776f7f579/stream
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, ou CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Le pourcentage d'avancement de la tâche. Il est à 0 jusqu'à ce que la tâche démarre et à 100 lorsqu'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 à 0 jusqu'à 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 à 0 jusqu'à 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 null sauf si le statut est FAILED. 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, ou SUCCEEDED. Il est à 0 pour une tâche FAILED, 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_animations est null.

    • 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 est 0.