API Rigging

Obligatoire sauf si vous envoyez model_url. L'ID de la tâche dont vous souhaitez riguer le modèle. Meshy prend en charge les modèles humanoïdes texturés.

Le modèle peut comporter au maximum 380 000 triangles (un quadrilatère compte pour 2), et un modèle qui en comporte davantage renvoie 400. Pour rester sous cette limite, exécutez d'abord l'API Remesh sur celui-ci avec un target_polycount de 300000 ou moins, ou de 150000 ou moins avec topology: quad.

Obligatoire sauf si vous envoyez input_task_id. Le modèle à riguer, 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 plus 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.

Le modèle peut comporter au maximum 380 000 triangles (un quadrilatère compte pour 2), et un modèle qui en comporte davantage renvoie 400. Pour rester sous cette limite, exécutez d'abord l'API Remesh sur celui-ci 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 comporter au maximum 10 000 000 faces. Un fichier qui en comporte davantage 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.

La taille approximative du personnage, en mètres. Meshy l'utilise pour mettre à l'échelle et riguer le modèle plus précisément. Une valeur négative renvoie 400.

Ne l'incluez pas lorsque le modèle possède ses propres textures. Sans ce paramètre, Meshy utilise les textures intégrées dans le 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 plus 20 Mo. Un autre format d'image renvoie 400.

La requête ne peut pas s'exécuter. Le message d'erreur indique le problème détecté. 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 parvient pas à télécharger le fichier model_url.
• Fichier 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 comporte plus de 10 000 000 faces. Réduisez le nombre de faces, puis renvoyez le fichier.
• Fichier modèle illisible : le fichier model_url dépasse 100 Mo, et Meshy ne parvient pas à lire son en-tête. Par exemple, il s'agit d'un GLB compressé avec Draco.
• En-tête du modèle trop complexe : le fichier model_url dépasse 100 Mo, et son en-tête comporte 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.
• Tâche d'entrée invalide : input_task_id ne correspond pas à une tâche API valide.
• Nombre de faces dépassé : le modèle d'entrée comporte plus de 380 000 triangles (un quadrilatère compte pour 2). Exécutez l'API Remesh sur celui-ci avec un target_polycount de 300000 ou moins, ou de 150000 ou moins avec topology: quad, avant de riguer le modèle.

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

La clé API est manquante ou invalide. Vérifiez l'en-tête Authorization.

Par exemple :

• Crédits insuffisants : le compte ne dispose pas de suffisamment 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.

input_task_id correspond à un modèle en bas-relief, que ce point de terminaison ne peut pas riguer. Le message est This model type does not support this operation. Envoyez un modèle différent.

L'estimation de pose a échoué. 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 également que le personnage est orienté vers l'axe +Z.

Vous avez dépassé votre limite de débit. Patientez, puis réessayez. Consultez Limites de débit.

L'ID de la tâche provenant de la réponse de création.

L'ID de la tâche à supprimer.

L'ID de la tâche provenant de la réponse de création.

L'ID de la tâche. Traitez-le comme une chaîne opaque, et ne vous fiez pas à son format.

Le type de tâche, toujours rig.

Le statut de la tâche, l'un de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, ou CANCELED.

La progression de la tâche, en pourcentage. Elle est 0 jusqu'à ce que la tâche démarre et 100 lorsqu'elle réussit.

Heure de création de la tâche, en millisecondes Unix.

Heure de début de la tâche, en millisecondes Unix. Elle est 0 jusqu'à ce que la tâche démarre.

Heure de fin de la tâche, en millisecondes Unix. Elle est 0 jusqu'à ce que la tâche se termine.

Heure d'expiration des fichiers de résultat de la tâche, en millisecondes Unix. Après cette heure, Meshy peut supprimer les fichiers.

Les détails de l'erreur lorsque la tâche échoue. Voir Erreurs.

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.

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.

Le nombre de tâches qui précèdent celle-ci dans la file d'attente. La valeur n'a de sens que pendant que la tâche est PENDING.