API de Retexturisation

Requis sauf si vous envoyez model_url. L'ID d'une tâche ayant produit un modèle 3D à texturer, par exemple une tâche Texte en 3D, Image en 3D, Remaillage ou Retexturisation. La tâche doit être une tâche que vous avez créée avec l'API et dont le statut est SUCCEEDED. Meshy texture le GLB de la tâche.

Requis sauf si vous envoyez input_task_id. Le modèle à texturer, 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 format Data URI. Pour un Data URI, utilisez le MIME type application/octet-stream, par exemple data:application/octet-stream;base64,<vos données de modèle encodées en base64>.

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

• Un fichier GLB, glTF, FBX ou OBJ peut avoir au plus 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.

Requis sauf si vous envoyez image_style_url ou multiview_image_urls. Texte décrivant la texture souhaitée, jusqu'à 800 caractères. Un texte plus long renvoie 400.

Requis sauf si vous envoyez text_style_prompt ou multiview_image_urls. Une image 2D dont le style sera suivi par la texture, sous forme d'URL publique ou de Data URI (data:image/jpeg;base64,<vos données d'image encodées en base64>). Si vous envoyez à la fois text_style_prompt et image_style_url, Meshy utilise image_style_url.

L'image doit être un fichier .jpg, .jpeg, .png ou .webp d'au plus 20 Mo.

La texture peut ne pas bien s'adapter lorsque l'objet de l'image a une forme très différente de celle du modèle.

Requis sauf si vous envoyez text_style_prompt ou image_style_url. Une à quatre images du même objet sous différents angles. La première image est la vue principale (avant). L'ordre des autres vues (gauche, arrière, droite) n'a pas d'importance. Un tableau vide, ou plus de quatre images, renvoie 400.

Chaque image suit les mêmes règles de format et de taille que image_style_url, soit au plus 20 Mo par image. Vous ne pouvez pas combiner multiview_image_urls avec text_style_prompt ou image_style_url.

multiview_image_urls nécessite un "ai_model": "meshy-7" explicite. Tout autre ai_model, y compris la valeur par défaut latest, renvoie 400.

Le modèle d'IA qui génère la texture.

Valeurs disponibles :

• meshy-6-lite
• meshy-6
• meshy-7
• latest : Meshy 7

Indique s'il faut conserver la disposition UV du modèle plutôt que d'en générer une nouvelle.

• Pour un modèle généré par Meshy, provenant d'un input_task_id ou d'un model_url pointant vers une sortie Meshy, utilisez true pour réutiliser sa disposition UV optimisée.
• Pour un modèle que vous avez importé d'ailleurs, utilisez true pour conserver des UV déjà satisfaisants. Laissez false pour laisser Meshy générer de nouveaux UV, ce qui convient à un modèle sans mappage UV approprié.

Indique s'il faut aussi générer des cartes PBR (métallique, rugosité et normale) avec la couleur de base. Avec meshy-6, Meshy génère aussi une carte d'émission, sauf à une texture_resolution de 8k. meshy-6-lite, meshy-7 et latest ne génèrent pas de carte d'émission.

La taille de la texture de couleur de base. Des résolutions plus élevées capturent davantage de détails de surface.

Valeurs disponibles :

• 2k : 2048 × 2048 pixels
• 4k : 4096 × 4096 pixels
• 8k : 8192 × 8192 pixels

4k et 8k nécessitent un ai_model égal à meshy-6, meshy-7 ou latest. Avec meshy-6-lite, ces valeurs renvoient 400. À 8k, Meshy ne génère pas de carte d'émission.

Utilisez plutôt texture_resolution. true équivaut à texture_resolution: "4k". Si vous envoyez les deux, Meshy utilise texture_resolution.

Indique s'il faut supprimer les reflets et les ombres de la texture de couleur de base. Le résultat fonctionne mieux sous votre propre éclairage.

Meshy l'applique uniquement avec meshy-6, à une texture_resolution de 2k ou 4k. Avec meshy-7 ou latest, ou à 8k, Meshy accepte ce paramètre mais l'ignore. Avec meshy-6-lite, l'envoyer avec n'importe quelle valeur renvoie 400.

Les formats de fichiers à générer. Meshy ne génère que les formats que vous listez, ce qui peut raccourcir la tâche. Si vous l'omettez, Meshy génère tous les formats sauf 3mf.

Valeurs disponibles :

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

Indique s'il faut aussi 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 détecté. Par exemple :

• Paramètre manquant : ni model_url ni input_task_id n'a été envoyé.
• Style manquant : aucun des paramètres text_style_prompt, image_style_url et multiview_image_urls n'a été envoyé.
• Entrées de style en conflit : multiview_image_urls a été envoyé avec text_style_prompt ou image_style_url.
• Modèle non pris en charge pour le multi-vue : multiview_image_urls a été envoyé sans "ai_model": "meshy-7" explicite.
• Tâche d'entrée invalide : input_task_id n'est pas une tâche réussie d'un type pris en charge.
• 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, l'image image_style_url, ou une image multiview_image_urls.
• 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 comporte 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 au format FBX binaire ou GLB.
• 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 GLB ou glTF compressé avec Draco, ou d'un FBX binaire antérieur à la version 7.1.
• En-tête de 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 image_style_url ou une image multiview_image_urls dépasse 20 Mo.

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.
• Forfait gratuit : la création d'une tâche nécessite un forfait payant. Mettez à niveau votre forfait dans vos paramètres d'abonnement, puis réessayez.

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

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

Le numéro de la 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. Considérez-le comme une chaîne opaque, et ne vous fiez pas à son format.

Le type de tâche, toujours retexture.

URL de téléchargement pour le modèle 3D texturé, une par format de fichier.

Le prompt textuel avec lequel vous avez créé la tâche.

L'image de style avec laquelle vous avez créé la tâche.

URL de téléchargement pour les images de référence multi-vue avec lesquelles vous avez créé la tâche. Présent uniquement lorsque vous avez créé la tâche avec multiview_image_urls.

URL de téléchargement pour une miniature du modèle.

URL de téléchargement pour une version de thumbnail_url avec un arrière-plan transparent (RGBA). Présent uniquement lorsque vous avez créé la tâche avec alpha_thumbnail: true et que Meshy a généré l'aperçu transparent.

La part de la tâche accomplie, en pourcentage. Elle est à 0 jusqu'au démarrage de la tâche et à 100 lorsqu'elle réussit.

Heure de démarrage de la tâche, en millisecondes Unix. Elle est à 0 jusqu'au démarrage de la tâche.

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

Heure d'expiration des résultats de la tâche, en millisecondes Unix.

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

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

URL de téléchargement pour les textures générées, sous forme de tableau d'objets. Le tableau contient généralement un seul objet. Chaque objet comporte les champs suivants :

Le nombre de tâches précédant celle-ci dans la file d'attente. Présent uniquement tant que la tâche est PENDING.

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.