API Relief

La photo à transformer en relief, sous forme d'URL publique ou de Data URI (data:image/png;base64,...).

L'image doit être un fichier JPG, JPEG, PNG ou WebP d'au plus 20 Mo, et d'au moins 32 × 32 pixels. Son côté le plus long peut mesurer au plus environ 16 fois son côté le plus court. Toute autre image renvoie 400. Meshy remplit les zones transparentes en noir avant de construire le relief.

Le style du relief. Il façonne la carte de profondeur et définit la valeur par défaut de carving_depth_mm.

Valeurs disponibles :

• high : gravure plus profonde, pour les pièces imprimées en 3D.
• low : gravure peu profonde, pour la gravure laser, l'usinage CNC et les plaques fines.

Envoyer null ou "" revient à l'omettre. Toute autre valeur renvoie 400.

Indique s'il faut construire le modèle de relief. Définissez-le sur false pour une tâche générant uniquement la carte de profondeur, sans modèle ni image d'aperçu. Meshy vérifie quand même les paramètres de taille, de gravure, de base, de courbure et de résolution, mais ne les utilise pas. Cela ne change pas le coût en crédits.

La longueur du côté le plus long de la photo sur le modèle, mesurée à plat avant toute courbure, de 20 à 250 millimètres. Avec remove_base, le modèle peut être plus petit.

Indique si le sujet ressort de la plaque ou y est découpé.

Valeurs disponibles :

• emboss : les parties les plus proches de la photo ressortent.
• engrave : la profondeur est inversée, de sorte que les parties les plus proches sont découpées en creux.

La carte de profondeur est identique dans les deux modes.

La profondeur de gravure du relief, de 0 à 60 millimètres. Avec remove_base défini sur true, 0 laisse un modèle vide. La tâche réussit quand même et coûte 20 crédits, et ses fichiers GLB et STL n'ont pas de géométrie.

Indique s'il faut découper l'arrière-plan et ne construire aucune plaque de base. Lorsqu'il est true, removal_threshold définit ce qui compte comme arrière-plan. Meshy vérifie removal_threshold dans tous les cas.

L'épaisseur de la plaque de base, de 0.1 à 10 millimètres. Lorsque remove_base est true, omettez-le ou envoyez 0.

Indique s'il faut courber le relief, et dans quel sens. Lorsqu'il n'est pas off, bend_axis et bend_angle façonnent la courbure. Meshy les vérifie dans tous les cas.

Valeurs disponibles :

• off : un relief plat.
• convex : l'avant se bombe vers l'extérieur.
• concave : l'avant se courbe vers l'intérieur.

Le nombre de points de maillage le long du côté le plus long de la photo, de 512 à 2048. Une valeur plus élevée conserve des détails plus fins et génère des fichiers plus volumineux. Avec la valeur par défaut 1024, le fichier GLB fait environ 40 à 50 Mo et le fichier STL environ 80 à 105 Mo. Une photo carrée donne les tailles les plus grandes. À 2048, elles sont d'environ 150 Mo et 300 Mo. Une courbure les rend plus volumineux : le fichier STL peut atteindre environ 800 Mo à 2048.

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

• Paramètre manquant : image_url n'a pas été envoyé.
• Paramètre invalide : Un paramètre a un type incorrect, est hors de sa plage, ou n'est pas l'une de ses valeurs disponibles. Par exemple, variant n'est pas high ou low, ou mesh_resolution n'est pas un entier compris entre 512 et 2048.
• Épaisseur de base : base_thickness_mm n'est pas 0 alors que remove_base est défini sur true, ou est inférieur à 0.1 sans cela.
• URL inaccessible : Meshy ne peut pas télécharger l'image image_url, par exemple parce que l'URL renvoie 404 ou expire.
• Image invalide : L'image n'est pas un fichier JPG, JPEG, PNG ou WebP, dépasse 20 Mo, est plus petite que 32 × 32 pixels, contient trop de pixels, ou ne peut pas être lue.
• Rapport d'aspect extrême : Le côté le plus long de l'image mesure plus d'environ 16 fois son côté le plus court.

Corrigez la requête, puis renvoyez-la. Meshy ne la facture pas. 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.
• Formule gratuite : La création d'une tâche nécessite une formule payante. Mettez à niveau votre formule dans les paramètres d'abonnement, puis réessayez.

La modération de contenu a bloqué l'image. Meshy ne facture pas la requête. Envoyez une image différente.

L'une de ces limites a été atteinte :

• Vous avez envoyé trop de requêtes. Attendez, puis réessayez. Voir Limites de débit.
• Trop de vos tâches sont en file d'attente ou en cours d'exécution. Attendez que certaines se terminent, puis réessayez.
• Sur une formule illimitée sans crédits restants, vous avez atteint le nombre de tâches pouvant s'exécuter sans crédits. Attendez qu'une tâche se termine, ou ajoutez des crédits.

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. Commence à 1, qui est également la valeur par défaut.

Le nombre de tâches par page, jusqu'à 100. La valeur par défaut est 10. Meshy traite une valeur comprise entre 101 et 255 comme 100, et une valeur supérieure renvoie 400.

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

URLs de téléchargement pour le modèle de relief. Les fichiers peuvent être volumineux ; mesh_resolution liste les tailles habituelles.

URL de téléchargement pour la carte de profondeur en niveaux de gris 16 bits à partir de laquelle le relief est construit. Les pixels plus clairs sont plus élevés. Les valeurs sont des hauteurs relatives, pas des millimètres. Les logiciels de gravure laser et de CNC peuvent l'utiliser comme carte de hauteur. Le fichier fait environ 1 à 2 Mo. Vide s'il n'y en a pas.

URL de téléchargement pour une image d'aperçu du modèle de relief. Vide si aucune n'a été rendue, y compris pour une tâche limitée à la carte de profondeur.

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

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

Le nombre de tâches devant celle-ci dans la file d'attente. Le champ est omis lorsque la valeur est 0, et n'apparaît donc que tant que des tâches précèdent celle-ci.

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

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

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

Horodatage de l'expiration du résultat 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 utilisés par la tâche : 20, ou 0 pour une tâche FAILED, que Meshy rembourse.