API Remaillage

Requis sauf si vous envoyez model_url. L'ID de la tâche dont vous souhaitez remailler le modèle, par exemple une tâche Texte en 3D, Image en 3D, Retexturisation ou Remaillage. La tâche doit avoir été créée par vous via l'API et avoir le statut SUCCEEDED.

Requis sauf si vous envoyez input_task_id. Le modèle à remailler, 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, glTF, OBJ, FBX ou STL d'au plus 400 Mo provenant d'une URL http ou https, ou de 100 Mo au maximum en tant que Data URI. Pour un Data URI, utilisez le MIME type application/octet-stream.

Un fichier de plus de 100 Mo doit également respecter ces règles :

• Un fichier GLB, glTF, FBX ou OBJ peut avoir au maximum 10 000 000 faces. Meshy compte les faces en triangles, donc un quadrilatère compte pour 2, et un maillage dessiné plusieurs fois compte une fois par copie.
• Un fichier FBX doit être au format binaire FBX 7.1 ou plus récent.
• Un fichier GLB ou glTF ne doit pas utiliser la compression Draco.

Les formats de fichiers à générer.

Valeurs disponibles :

• glb
• fbx
• obj
• usdz
• blend
• stl
• 3mf

Le type de face du modèle remaillé.

Valeurs disponibles :

• quad : un maillage à dominance de quadrilatères
• triangle : un maillage triangulaire décimé

Le nombre de faces visé, de 100 à 300000. Le résultat peut différer de la cible, selon la géométrie du modèle. Une valeur hors de la plage renvoie 400.

Nombre de faces adaptatif, par niveau. Lorsque vous le définissez, Meshy ignore target_polycount.

Valeurs disponibles :

• 1 : ultra
• 2 : élevé
• 3 : moyen
• 4 : faible

Utilisez plutôt l'API Resize. La hauteur à laquelle redimensionner le modèle, en mètres. Envoyez au plus un des paramètres resize_height, resize_longest_side et auto_size.

Utilisez plutôt l'API Resize. La longueur à laquelle redimensionner le côté le plus long de la boîte englobante du modèle, en mètres. Envoyez au plus un des paramètres resize_height, resize_longest_side et auto_size.

Utilisez plutôt l'API Resize. Indique s'il faut estimer la hauteur réelle de l'objet avec la vision par IA et redimensionner le modèle en conséquence. Envoyez au plus un des paramètres resize_height, resize_longest_side et auto_size.

Utilisez plutôt l'API Resize. L'emplacement de l'origine du modèle, bottom ou center. La valeur par défaut s'applique lorsque vous envoyez resize_height, resize_longest_side ou auto_size. Sans l'un d'eux, Meshy ne déplace l'origine que si vous envoyez origin_at.

Utilisez plutôt l'API Convert. Indique s'il faut seulement convertir le modèle vers target_formats. Lorsque la valeur est true, Meshy ignore topology, target_polycount, decimation_mode, resize_height, resize_longest_side et auto_size, mais vérifie quand même leurs valeurs, donc une valeur invalide renvoie 400. Avec convert_format_only: true, un target_formats vide ou null renvoie 400.

Indique s'il faut également générer un aperçu avec un arrière-plan transparent (RGBA), renvoyé dans alpha_thumbnail_url lorsque vous récupérez la tâche. thumbnail_url ne change pas.

La requête ne peut pas s'exécuter. Le message d'erreur indique le problème rencontré. Par exemple :

• Paramètre manquant : Ni model_url ni input_task_id n'ont été envoyés.
• Tâche d'entrée invalide : input_task_id ne correspond pas à une tâche API réussie, ou son modèle d'IA ne prend pas en charge le remaillage.
• Format de modèle invalide : Le fichier model_url a une extension non prise en charge.
• URL inaccessible : Meshy ne peut 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 a plus de 10 000 000 faces. Réduisez le nombre de faces, puis renvoyez le fichier.
• FBX ASCII de plus de 100 Mo : Le fichier model_url est un FBX ASCII de plus de 100 Mo. Envoyez-le en FBX binaire ou en GLB.
• Fichier 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 GLB ou glTF compressé avec Draco, ou d'un FBX binaire antérieur à 7.1.
• 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, nœuds ou enregistrements à vérifier. Réduisez le nombre d'objets dans le fichier, puis renvoyez-le.
• Topologie invalide : topology n'est ni quad ni triangle.
• Paramètres mutuellement exclusifs : La requête contient plus d'un des paramètres auto_size, resize_height et resize_longest_side. N'en envoyez qu'un seul.

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

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

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.

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

input_task_id ne correspond à aucune de vos tâches. Vérifiez l'ID de la tâche, puis renvoyez la requête.

Vous avez dépassé votre limite de débit. Attendez, puis réessayez. Voir 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.

Le numéro de page à renvoyer.

Le nombre de tâches par page, jusqu'à 100.

L'ordre de tri.

Valeurs disponibles :

• +created_at : du plus ancien au plus récent
• -created_at : du plus récent au plus ancien

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 remesh.

URLs de téléchargement pour le modèle remaillé, une par format de fichier. Un format que la tâche n'a pas généré n'a pas de clé, plutôt qu'une chaîne vide.

URL de téléchargement pour une image d'aperçu du modèle remaillé.

URL de téléchargement pour une version de thumbnail_url avec un fond transparent (RGBA). Présent uniquement lorsque vous avez créé la tâche avec alpha_thumbnail: true et que Meshy a rendu l'aperçu transparent.

La part de la tâche déjà effectuée, en pourcentage. C'est 0 jusqu'à ce que la tâche démarre et 100 lorsqu'elle réussit.

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

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

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

Horodatage de démarrage de la tâche, en millisecondes Unix. C'est 0 jusqu'à ce que la tâche démarre.

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

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

Le nombre de crédits que la tâche a utilisés. Présent lorsque le statut est PENDING, IN_PROGRESS ou SUCCEEDED. C'est 0 pour une tâche FAILED, car Meshy rembourse les crédits lorsqu'une tâche échoue.