API Texte en 3D

Ce champ doit être défini sur "preview" lors de la création d'une tâche d'aperçu.

Décrivez quel type d'objet est le modèle 3D. Maximum 600 caractères.

Spécifiez le type de génération de maillage 3D.

Valeurs disponibles :

• standard: Génération de maillage 3D régulier à haut détail.
• lowpoly: Génère un maillage low-poly optimisé pour des polygones plus propres.

ID du modèle à utiliser. Valeurs disponibles : meshy-5, meshy-6, latest (Meshy 6).

Contrôle si la phase de remaillage doit être activée. Pour un modèle de la meilleure qualité, nous recommandons de définir should_remesh sur false.

Obsolète. Ce paramètre n'affecte plus la sortie.

Le champ symmetry_mode contrôle le comportement de la symétrie pendant le processus de génération du modèle.

Les valeurs valides sont :

• off: Désactive la symétrie.
• auto: Détermine et applique automatiquement la symétrie en fonction de la géométrie d'entrée.
• on: Applique la symétrie pendant la génération.

Spécifiez le mode de pose pour le modèle généré.

Valeurs disponibles :

• a-pose: Générer le modèle dans une pose A.
• t-pose: Générer le modèle dans une pose T.
• "" (chaîne vide): Aucune pose spécifique appliquée.

Utilisez pose_mode à la place. Si le modèle doit être généré dans une pose A/T.

Non pris en charge par Meshy-6. Les requêtes utilisant Meshy-6 ignoreront art_style, et certaines combinaisons peuvent provoquer des erreurs. Valeurs disponibles : realistic, sculpture.

Lorsqu'il est défini sur true, le contenu d'entrée sera automatiquement filtré pour détecter un contenu potentiellement nuisible. Si un contenu nuisible est détecté, la tâche ne passera pas à la génération.

Le texte de prompt sera filtré.

Spécifie quels formats de fichiers 3D inclure dans la sortie. Seuls les formats demandés seront générés et retournés, ce qui peut réduire le temps d'exécution de la tâche. Lorsqu'il est omis, tous les formats pris en charge sont inclus.

Valeurs disponibles : glb, obj, fbx, stl, usdz, 3mf

Lorsqu'il est défini sur true, la tâche rend également une version à fond transparent (RGBA) de l'aperçu et la retourne comme alpha_thumbnail_url dans la réponse GET. Le champ existant thumbnail_url reste inchangé.

Lorsqu'il est défini sur true, le service utilise la vision AI pour estimer automatiquement la hauteur réelle de l'objet et redimensionne le modèle en conséquence. L'origine sera par défaut bottom sauf si origin_at est explicitement défini.

La requête était inacceptable. Causes courantes :

• Paramètre manquant : Un paramètre requis (par exemple, prompt, mode) est manquant.
• Paramètre invalide : art_style n'est pas l'une des valeurs autorisées.
• Prompt trop long : Le prompt dépasse la limite de caractères.

L'authentification a échoué. Veuillez vérifier votre clé API.

Crédits insuffisants pour effectuer cette tâche.

Vous avez dépassé votre limite de débit.

Ce champ doit être défini sur "refine" lors de la création d'une tâche de raffinage.

L'ID de tâche d'aperçu correspondant.

Le statut de la tâche d'aperçu donnée doit être SUCCEEDED.

Générer des cartes PBR (métallique, rugosité, normal) en plus de la couleur de base. Une carte d'émission est également incluse lorsque ai_model est meshy-6 ou latest, sauf à texture_resolution: 8k (aucune carte d'émission n'est produite).

Résolution de la texture de couleur de base. L'un des 2k (2048×2048), 4k (4096×4096), ou 8k (8192×8192). Les résolutions plus élevées capturent plus de détails de surface. Ne s'applique qu'au mode refine.

Utilisez texture_resolution à la place — équivalent à texture_resolution: "4k". Lorsque les deux sont définis, texture_resolution a priorité.

Fournissez un texte prompt supplémentaire pour guider le processus de texturation. Maximum 600 caractères.

Fournissez une image 2D pour guider le processus de texturation. Nous prenons actuellement en charge les formats .jpg, .jpeg, et .png.

Il y a deux façons de fournir l'image :

• URL accessible publiquement : Une URL accessible depuis Internet public
• Data URI : Un Data URI encodé en base64 de l'image. Exemple de Data URI : data:image/jpeg;base64,<votre image encodée en base64>

ID du modèle à utiliser pour le raffinage. Valeurs disponibles : meshy-5, meshy-6, latest (Meshy 6).

Lorsqu'il est défini sur true, le contenu d'entrée sera automatiquement filtré pour détecter un contenu potentiellement nuisible. Si un contenu nuisible est détecté, la tâche ne passera pas à la génération.

À la fois le texte de texture_prompt et l'image de texture_image_url seront filtrés.

Supprime les reflets et les ombres de la texture de couleur de base, produisant un résultat plus propre qui fonctionne mieux sous des configurations d'éclairage personnalisées.

Spécifie quels formats de fichiers 3D inclure dans la sortie. Seuls les formats demandés seront générés et retournés, ce qui peut réduire le temps d'exécution de la tâche. Lorsqu'il est omis, tous les formats pris en charge sont inclus.

Valeurs disponibles : glb, obj, fbx, stl, usdz, 3mf

Lorsqu'il est défini sur true, la tâche rend également une version à fond transparent (RGBA) de l'aperçu et la retourne comme alpha_thumbnail_url dans la réponse GET. Le champ existant thumbnail_url reste inchangé.

Lorsqu'il est défini sur true, le service utilise la vision AI pour estimer automatiquement la hauteur réelle de l'objet et redimensionne le modèle en conséquence. L'origine sera par défaut bottom sauf si origin_at est explicitement défini.

La requête était inacceptable. Causes courantes :

• ID de tâche invalide : Le preview_task_id est invalide ou n'existe pas.
• Tâche non prête : La tâche d'aperçu n'a pas encore réussi.
• Incompatibilité de modèle : Le modèle AI de la tâche d'aperçu est incompatible avec le modèle de raffinage demandé.

L'authentification a échoué. Veuillez vérifier votre clé API.

Crédits insuffisants pour effectuer cette tâche.

La tâche d'aperçu spécifiée par preview_task_id est introuvable.

Vous avez dépassé votre limite de débit.

Identifiant unique de la tâche Texte en 3D à récupérer.

L'ID de la tâche Texte en 3D à supprimer.

Numéro de page pour la pagination.

Limite de taille de page. Le maximum autorisé est de 50 éléments.

Champ par lequel trier.

Valeurs disponibles :

• +created_at: Trier par temps de création dans l'ordre croissant.
• -created_at: Trier par temps de création dans l'ordre décroissant.

Identifiant unique de la tâche Texte en 3D à diffuser.

Identifiant unique de la tâche. Bien que nous utilisions un UUID triable par k pour les identifiants des tâches en tant que détail d'implémentation, vous ne devez faire aucune supposition sur le format de l'identifiant.

Type de la tâche Texte en 3D. Les valeurs possibles sont text-to-3d-preview pour les tâches de l'étape d'aperçu et text-to-3d-refine pour les tâches de l'étape de raffinage.

URL téléchargeable du fichier modèle 3D texturé généré par Meshy. La propriété pour un format sera omise si le format n'est pas généré au lieu de retourner une chaîne vide.

Il s'agit du prompt non modifié qui a été utilisé pour créer la tâche.

Maintenu pour la compatibilité ascendante. Ce champ n'a aucun impact fonctionnel sur les modèles générés.

Le art_style non modifié qui a été utilisé pour créer la tâche d'aperçu. Non pris en charge par Meshy-6.

Maintenu pour la compatibilité ascendante. Ce champ n'a aucun impact fonctionnel sur les modèles générés.

Texte prompt supplémentaire fourni pour guider le processus de texturation pendant l'étape de raffinage.

URL téléchargeable de l'image de texture qui a été utilisée pour guider le processus de texturation.

URL téléchargeable de l'image miniature du fichier modèle.

URL téléchargeable d'une version à fond transparent (RGBA) de thumbnail_url. Présent uniquement lorsque la tâche a été créée avec alpha_thumbnail: true et que l'aperçu transparent a été rendu avec succès ; sinon, ce champ est omis.

URL téléchargeable de la vidéo d'aperçu. Sera supprimée dans une future version.

Progression de la tâche. Si la tâche n'est pas encore commencée, cette propriété sera 0. Une fois la tâche réussie, elle deviendra 100.

Horodatage du moment où la tâche a été commencée, en millisecondes. Si la tâche n'est pas encore commencée, cette propriété sera 0.

Horodatage du moment où la tâche a été créée, en millisecondes.

Horodatage du moment où la tâche a été terminée, en millisecondes. Si la tâche n'est pas encore terminée, cette propriété sera 0.

Statut de la tâche. Les valeurs possibles sont l'une de PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

Un tableau d'objets URL de texture générés à partir de la tâche. Normalement, cela ne contient qu'un seul objet URL de texture. Chaque URL de texture a les propriétés suivantes :

Le nombre de tâches précédentes.

Détails de l'erreur pour les tâches échouées. Voir Erreurs pour la référence complète de l'objet task_error.

Le nombre de crédits consommés par cette tâche. Présent lorsque le statut de la tâche est PENDING, IN_PROGRESS, ou SUCCEEDED. Renvoie 0 pour les tâches FAILED (les crédits sont remboursés en cas d'échec).