API Multi-image en 3D
Générez un modèle 3D à partir d'une à quatre images du même objet, prises sous différents angles.
Créer une tâche Multi-image en 3D
Crée une tâche Multi-image en 3D. La tâche s'exécute en arrière-plan. Pour connaître la durée habituelle d'une tâche, consultez Temps de traitement. Pour connaître les champs d'une tâche, consultez L'objet de tâche Multi-image en 3D.
Request
# Simple request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"image_urls": [
"<your publicly accessible image url or base64-encoded data URI>",
"<your second publicly accessible image url or base64-encoded data URI>"
]
}'
# With Ultra 2K geometry, PBR texturing, and GLB format
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"image_urls": [
"<your publicly accessible image url or base64-encoded data URI>",
"<your second publicly accessible image url or base64-encoded data URI>"
],
"ai_model": "meshy-7.1",
"geometry_resolution": "2k",
"should_texture": true,
"enable_pbr": true,
"target_formats": ["glb"]
}'
# Textured with Meshy N1 from the input images, the first as the front view
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"image_urls": [
"<your front view image url or base64-encoded data URI>",
"<your back view image url or base64-encoded data URI>"
],
"ai_model": "meshy-7.1",
"texture_model": "meshy-n1"
}'
Response
{
"result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
Paramètres
- Name
- input_task_id
- Type
- string
- Requis
- Description
Obligatoire sauf si vous envoyez
image_urls. L'ID d'une tâche Texte en image ou Image en image, y compris une tâche multi-vue. Meshy utilise ses une à quatre images comme entrée. La tâche doit être une tâche que vous avez créée avec l'API et dont le statut estSUCCEEDED.
- Name
- image_urls
- Type
- array
- Requis
- Description
Obligatoire sauf si vous envoyez
input_task_id. Une à quatre images, chacune sous forme d'URL publique ou de data URI, commedata:image/jpeg;base64,<vos données d'image encodées en base64>. Si vous envoyez les deux, Meshy utiliseinput_task_id.Chaque image doit être un fichier
.jpg,.jpeg,.pngou.webpd'au plus 20 Mo, d'au moins 32 pixels de chaque côté, et d'au plus 178 956 970 pixels (largeur × hauteur). Plus de quatre images renvoie400.Pour de meilleurs résultats, les images doivent montrer le même objet sous différents angles. Avec
meshy-7.1oulatest, Meshy utilise la première image comme vue de face, et l'ordre des autres n'a pas d'importance.
- Name
- ai_model
- Type
- string
- défaut latest
- Description
Le modèle d'IA qui génère le modèle 3D.
Valeurs disponibles :
latest: Meshy 7.1meshy-7.1meshy-6meshy-6-litemeshy-7: obsolète, envoyezmeshy-7.1à la place. Il sera retiré le 31 décembre 2026.
Consultez Modèles pour savoir quel modèle convient à votre projet, comme un objet réel ou une impression 3D.
- Name
- geometry_resolution
- Type
- string
- défaut standard
- Description
Le niveau de détail géométrique à générer.
Valeurs disponibles :
standard2k: exécute la passe Ultra à 2048³. Nécessitemeshy-7.1,latest, ou l'obsolètemeshy-7.
- Name
- ultra_mode
- Type
- boolean
- ⚠ obsolète
- défaut false
- Description
Envoyez
geometry_resolutionà la place.ultra_mode: trueéquivaut àgeometry_resolution: "2k".
- Name
- should_texture
- Type
- boolean
- défaut true
- Description
Indique s'il faut générer des textures.
truerenvoie un modèle texturé, etfalsesaute l'étape de texture et renvoie un maillage sans textures.
should_texture = true- Name
- texture_model
- Type
- string
- défaut depends on ai_model
- Description
Le modèle d'IA qui texture le modèle 3D à partir de plusieurs vues, dans la même tâche. Omettez-le pour utiliser le modèle de texture par défaut pour votre
ai_model. Cela ne change pas le coût en crédits.Valeurs disponibles :
meshy-7: Meshy 7, avec cartes PBR et textures jusqu'à 8Kmeshy-n1: Meshy N1, une texture de couleur de base en 2K uniquement à partir d'images de référence
Chaque
ai_modelaccepte les deux. Une requête texturée avecmeshy-6oumeshy-6-literenvoie400, tout comme une option que le modèle de texture choisi ne prend pas en charge. Avecshould_texture: false, Meshy ignoretexture_model, mais une valeur inconnue renvoie quand même400.Avec
meshy-n1, Meshy texture à partir detexture_image_urlsoutexture_image_url, ou à partir des images d'entrée lorsque vous n'envoyez ni l'un ni l'autre. La première image est la vue de face. Un modèle généré dépassant 7 999 999 triangles fait échouer la tâche, et Meshy rembourse ses crédits.Consultez Modèles pour savoir ce que fait chaque modèle de texture et lequel choisir.
- Name
- enable_pbr
- Type
- boolean
- défaut false
- Description
Indique s'il faut aussi générer des cartes de métallicité, de rugosité et de normales, en plus de la couleur de base. Le modèle de texture Meshy 6 génère aussi une carte d'émission, sauf à
texture_resolution: 8k. Avectexture_model: meshy-n1,truerenvoie400.
- Name
- texture_resolution
- Type
- string
- défaut 2k
- Description
La taille de la texture de couleur de base. Une taille plus grande capture plus de détails de surface.
Valeurs disponibles :
2k: 2048×20484k: 4096×40968k: 8192×8192
4ket8knécessitent le modèle de texture Meshy 7 ou Meshy 6, et renvoient400avec les autres. À8k, Meshy ne génère pas de carte d'émission.
- Name
- hd_texture
- Type
- boolean
- ⚠ obsolète
- défaut false
- Description
Envoyez
texture_resolutionà la place.hd_texture: trueéquivaut àtexture_resolution: "4k". Si vous envoyez les deux, Meshy utilisetexture_resolution.
- Name
- texture_prompt
- Type
- string
- Description
Texte qui guide la texture, jusqu'à 800 caractères. Un texte plus long renvoie
400. Avectexture_model: meshy-n1, l'envoyer renvoie400.
- Name
- texture_image_url
- Type
- string
- Description
Une image 2D qui guide la texture, sous forme d'URL publique ou de data URI, comme
data:image/jpeg;base64,<vos données d'image encodées en base64>. L'image doit être un fichier.jpg,.jpeg,.pngou.webpd'au plus 20 Mo, d'au moins 32 pixels de chaque côté, et d'au plus 178 956 970 pixels (largeur × hauteur).Si vous envoyez à la fois
texture_image_urlettexture_prompt, Meshy utilisetexture_prompt. Avectexture_model: meshy-n1, Meshy texture à partir de cette image comme vue de face.La texture peut ne pas bien rendre lorsque la forme dans l'image diffère beaucoup du modèle 3D.
- Name
- texture_image_urls
- Type
- string[]
- Description
Une à quatre images de l'objet sous différentes vues qui guident la texture. Meshy utilise la première image comme vue de face. L'ordre des autres vues (gauche, arrière, droite) n'a pas d'importance.
Chaque image suit les mêmes règles que
texture_image_url. C'est une URL publique ou une data URI, au format.jpg,.jpeg,.pngou.webp, d'au plus 20 Mo, d'au moins 32 pixels de chaque côté, et d'au plus 178 956 970 pixels (largeur × hauteur).Ces images guident uniquement la texture et ne dépendent pas de
image_urls. Les deux listes peuvent contenir des images différentes et un nombre différent d'images.texture_image_urlsnécessite le modèle de texture Meshy 7 ou Meshy N1. Envoyez-le avec l'un de ces éléments :ai_modeldemeshy-7.1,latest, ou l'obsolètemeshy-7texture_modeldemeshy-7oumeshy-n1
Vous ne pouvez pas l'envoyer avec
texture_image_urloutexture_prompt.
- Name
- should_remesh
- Type
- boolean
- défaut true (meshy-6-lite), false (other models)
- Description
Indique s'il faut remailler le modèle après la génération. Pour le modèle 3D de la meilleure qualité, réglez-le sur
false.
should_remesh = true- Name
- topology
- Type
- string
- défaut triangle
- Description
Le type de faces du modèle remaillé.
Valeurs disponibles :
quad: un maillage à dominante de quadrilatèrestriangle: un maillage triangulaire décimé
Avec
texture_model: meshy-n1,quadrenvoie400lorsque le modèle est remaillé, ce quemeshy-6-litefait par défaut.
- Name
- target_polycount
- Type
- integer
- défaut 30000
- Description
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 en dehors de la plage renvoie400.
- Name
- decimation_mode
- Type
- integer
- Description
Nombre de faces adaptatif, par niveau. Lorsque vous le définissez, Meshy ignore
target_polycount.Valeurs disponibles :
1: ultra2: élevé3: moyen4: faible
- Name
- save_pre_remeshed_model
- Type
- boolean
- défaut false
- Description
Indique s'il faut aussi enregistrer le GLB d'avant le remaillage, renvoyé dans
model_urls.pre_remeshed_glb.
- Name
- symmetry_mode
- Type
- string
- ⚠ obsolète
- défaut auto
- Description
Omettez-le. Cela n'affecte pas le résultat.
Valeurs disponibles :
off: aucune symétrieauto: symétrie basée sur la géométrie d'entréeon: symétrie imposée
- Name
- pose_mode
- Type
- string
- Description
La pose d'un modèle de personnage,
a-poseout-pose. Pour n'avoir aucune pose, omettezpose_modeetis_a_t_pose.
- Name
- is_a_t_pose
- Type
- boolean
- ⚠ obsolète
- défaut false
- Description
Envoyez
pose_modeà la place. Indique s'il faut générer le modèle en pose A ou T.
- Name
- image_enhancement
- Type
- boolean
- défaut true
- Description
Indique s'il faut optimiser les images d'entrée avant la génération.
falseconserve l'aspect exact des images d'entrée, sans traitement de style. Pris en charge uniquement avecmeshy-6,meshy-7.1, oulatest. L'envoyer avecmeshy-6-literenvoie400.
- Name
- remove_lighting
- Type
- boolean
- défaut true
- Description
Indique s'il faut retirer les reflets et les ombres de la texture de couleur de base. Le résultat plus propre fonctionne mieux sous votre propre éclairage. Seul le modèle de texture Meshy 6 l'utilise, et à
texture_resolution: 8kil retire toujours l'éclairage. Avectexture_model: meshy-n1,truerenvoie400. Avecai_model: meshy-6-liteet son modèle de texture par défaut, l'envoyer renvoie400.
- Name
- moderation
- Type
- boolean
- défaut false
- Description
Indique s'il faut filtrer les entrées pour détecter du contenu nuisible. Meshy filtre chaque image d'entrée,
texture_image_urlou chaque image detexture_image_urls, et le texte detexture_prompt. Si Meshy trouve du contenu nuisible, la requête renvoie400et Meshy ne crée pas de tâche.
- Name
- target_formats
- Type
- string[]
- Description
Les formats de fichiers 3D à générer. Meshy génère et renvoie uniquement les formats que vous listez, ce qui peut raccourcir la tâche.
Valeurs disponibles :
glbobjfbxstlusdz3mf
Si vous l'omettez, Meshy génère tous les formats sauf
3mf. Meshy génère3mfuniquement lorsque vous le listez.
- Name
- auto_size
- Type
- boolean
- défaut false
- Description
Indique s'il faut estimer la hauteur réelle de l'objet par vision IA et redimensionner le modèle en conséquence. Meshy place l'origine en bas sauf si vous définissez
origin_at.
auto_size = true- Name
- origin_at
- Type
- string
- défaut bottom
- Description
Où placer l'origine du modèle,
bottomoucenter.
- Name
- alpha_thumbnail
- Type
- boolean
- défaut false
- Description
Indique s'il faut aussi rendre un aperçu avec un arrière-plan transparent (RGBA), renvoyé dans
alpha_thumbnail_urllorsque vous récupérez la tâche.thumbnail_urlne change pas.
- Name
- multi_view_thumbnails
- Type
- boolean
- défaut false
- Description
Indique s'il faut aussi rendre des aperçus avant, droit, arrière et gauche, renvoyés dans
thumbnail_urlslorsque vous récupérez la tâche.thumbnail_urlne change pas et montre toujours la vue de face. Cela ajoute environ 5 secondes à la tâche.
Retours
Le champ result de la réponse contient l'ID de la nouvelle tâche Multi-image en 3D.
Modes d'échec
- Name
400 - Bad Request- Description
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
image_urlsniinput_task_idn'a été envoyé. - Tâche d'entrée invalide :
input_task_idn'est pas une tâche Texte en image ou Image en image au statutSUCCEEDED, ni une tâche multi-vue. - Nombre d'images invalide :
image_urlsoutexture_image_urlsne contient pas de 1 à 4 images. - Format d'image invalide : une image dans
image_urlsn'est pas dans un format pris en charge. - Entrées de texture en conflit :
texture_image_urlsa été envoyé avectexture_image_url, avectexture_prompt, ou avecshould_texture: false. - Modèle non pris en charge pour la texture multi-vue :
texture_image_urlsa été envoyé avecai_modeldemeshy-6oumeshy-6-lite, sauf sitexture_modelestmeshy-7oumeshy-n1. - URL inaccessible : Meshy ne peut pas télécharger une image dans
image_urlsoutexture_image_urls. - Image trop grande : une image dans
image_urls,texture_image_url, outexture_image_urlsdépasse 20 Mo. - Taille d'image invalide : une image dans
image_urls,texture_image_url, outexture_image_urlsa un côté plus court que 32 pixels, ou plus de 178 956 970 pixels (largeur × hauteur). - Résolution non prise en charge pour une entrée multi-image :
geometry_resolutionest"4k", ce que ce point de terminaison ne prend pas en charge. Utilisez2koustandard. - Modèle non pris en charge pour les options d'image :
image_enhancementa été envoyé avecai_model: "meshy-6-lite", ouremove_lightinga été envoyé avecai_model: "meshy-6-lite"et son modèle de texture par défaut. - Modèle de texture invalide :
texture_modeln'est pas un nom de modèle de texture valide. - Modèle de texture non disponible : une requête texturée a envoyé
texture_modeldemeshy-6oumeshy-6-lite. Multi-image en 3D n'accepte que les modèles de texture qui texturent à partir de plusieurs vues. Envoyezmeshy-7oumeshy-n1, ou ometteztexture_model. - Option non prise en charge pour le modèle de texture : la requête demande au modèle de texture une option qu'il ne prend pas en charge, comme
enable_pbr: trueavecmeshy-n1ou une texture4kavecmeshy-6-lite. Consultez Modèles.
Corrigez la requête, puis renvoyez-la. Consultez Erreurs.
- Paramètre manquant : ni
- Name
401 - Unauthorized- Description
La clé API est manquante ou invalide. Vérifiez l'en-tête
Authorization.
- Name
402 - Payment Required- Description
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 : créer une tâche nécessite un plan payant. Mettez à niveau votre plan dans vos paramètres d'abonnement, puis réessayez.
- Name
403 - Forbidden- Description
La modération du contenu a bloqué le prompt ou une image d'entrée. Modifiez l'entrée, puis réessayez.
- Name
404 - Not Found- Description
input_task_idne correspond à aucune de vos tâches. Vérifiez l'ID de la tâche, puis renvoyez la requête.
- Name
429 - Too Many Requests- Description
Vous avez dépassé votre limite de débit. Attendez, puis réessayez. Consultez Limites de débit.
Récupérer une tâche Multi-image en 3D
Renvoie une tâche Multi-image en 3D à partir de son ID.
Request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "multi-image-to-3d",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
"pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"thumbnail_urls": {
"front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
"right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
"back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
"left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
},
"texture_prompt": "",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"preceding_tasks": 0,
"task_error": null,
"consumed_credits": 30
}
Paramètres
- Name
- id
- Type
- path
- Description
L'ID de la tâche obtenu dans la réponse de création.
Retourne
Supprimer une tâche Multi-image en 3D
Supprime définitivement une tâche Multi-image en 3D, y compris ses modèles et ses données. Vous ne pouvez pas annuler une suppression.
Request
curl --request DELETE \
--url https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS. The task keeps running:
{
"message": "Task is IN_PROGRESS and cannot be deleted. Credits for a task the worker has already started are not refundable; wait for it to reach SUCCEEDED, FAILED or CANCELED, then delete it."
}
Paramètres de chemin
- Name
- id
- Type
- path
- Description
L'ID de la tâche à supprimer.
Statut de la tâche
Supprimer une tâche PENDING rembourse les crédits utilisés lors de sa création.
Une tâche IN_PROGRESS ne peut pas être supprimée. La requête renvoie 409 Conflict,
et la tâche continue de s'exécuter. Meshy ne rembourse pas une tâche qui a démarré,
donc la supprimer vous ferait perdre à la fois les crédits et le résultat. Attendez
qu'elle atteigne le statut SUCCEEDED, FAILED ou CANCELED, puis supprimez-la.
Supprimer une tâche dans un statut final (SUCCEEDED, FAILED ou CANCELED)
ne rembourse pas ses crédits.
Retours
200 OK lorsque la tâche est supprimée, ou 409 Conflict lorsque la tâche est
IN_PROGRESS.
Liste des tâches Multi-image en 3D
Renvoie une liste de vos tâches Multi-image en 3D.
Request
curl https://api.meshy.ai/openapi/v1/multi-image-to-3d?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response
[
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "multi-image-to-3d",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
"pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"thumbnail_urls": {
"front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
"right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
"back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
"left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
},
"texture_prompt": "",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"preceding_tasks": 0,
"task_error": null,
"consumed_credits": 30
}
]
Paramètres
- Name
- page_num
- Type
- integer
- défaut 1
- Description
Le numéro de page à renvoyer, jusqu'à
255. Une valeur plus élevée renvoie400.
- Name
- page_size
- Type
- integer
- défaut 10
- Description
Le nombre de tâches par page, jusqu'à
100.
- Name
- sort_by
- Type
- string
- Description
L'ordre de tri.
Valeurs disponibles :
+created_at: du plus ancien au plus récent-created_at: du plus récent au plus ancien
Retours
Une liste paginée d'objets de tâche Multi-image en 3D.
Diffuser les mises à jour d'une tâche Multi-image en 3D
Diffuse les mises à jour d'une tâche Multi-image en 3D sous forme d'événements envoyés par le serveur (SSE).
Request
curl -N https://api.meshy.ai/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"
Response Stream
// Error event example
event: error
data: {
"status_code": 404,
"message": "Task not found"
}
// Message event examples illustrate task progress.
// These examples are shortened. Each event holds the full task object.
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"progress": 0,
"status": "PENDING"
}
event: message
data: {
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "multi-image-to-3d",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
"pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"thumbnail_urls": {
"front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
"right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
"back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
"left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
},
"texture_prompt": "",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"preceding_tasks": 0,
"task_error": null,
"consumed_credits": 30
}
Paramètres
- Name
- id
- Type
- path
- Description
L'ID de la tâche provenant de la réponse de création.
Retours
Un flux d'objets de tâche Multi-image en 3D sous forme d'événements envoyés par le serveur.
Chaque événement contient l'objet de tâche complet, au même format que celui renvoyé par le point de terminaison Get. Tant que la tâche est PENDING ou IN_PROGRESS, ses champs de résultat n'ont pas encore de valeurs.
L'objet de tâche Multi-image en 3D
Un objet de tâche Multi-image en 3D décrit une génération de modèle 3D à partir d'une à quatre images d'un objet. Il contient le statut, la progression et les fichiers du modèle lorsque la tâche réussit.
Propriétés
Example Multi-Image to 3D Task Object
{
"id": "018a210d-8ba4-705c-b111-1f1776f7f578",
"type": "multi-image-to-3d",
"model_urls": {
"glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.glb?Expires=***",
"fbx": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.fbx?Expires=***",
"obj": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.obj?Expires=***",
"usdz": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.usdz?Expires=***",
"stl": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/model.stl?Expires=***",
"pre_remeshed_glb": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/pre_remeshed_model.glb?Expires=***"
},
"thumbnail_url": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview.png?Expires=***",
"thumbnail_urls": {
"front": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_front.png?Expires=***",
"right": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_right.png?Expires=***",
"back": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_back.png?Expires=***",
"left": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/preview_left.png?Expires=***"
},
"texture_prompt": "",
"progress": 100,
"started_at": 1692771667037,
"created_at": 1692771650657,
"expires_at": 1692771679037,
"finished_at": 1692771669037,
"status": "SUCCEEDED",
"texture_urls": [
{
"base_color": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0.png?Expires=***",
"metallic": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_metallic.png?Expires=XXX",
"normal": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_normal.png?Expires=XXX",
"roughness": "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/texture_0_roughness.png?Expires=XXX"
}
],
"preceding_tasks": 0,
"task_error": null,
"consumed_credits": 30
}
- Name
- id
- Type
- string
- Description
L'ID de la tâche. Traitez-le comme une chaîne opaque et ne vous fiez pas à son format.
- Name
- type
- Type
- string
- Description
Le type de tâche, toujours
multi-image-to-3d.
- Name
- model_urls
- Type
- object
- Description
URLs de téléchargement pour le modèle 3D généré, 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.
- Name
glb- Type
- string
- Description
Le fichier GLB.
- Name
fbx- Type
- string
- Description
Le fichier FBX.
- Name
obj- Type
- string
- Description
Le fichier OBJ.
- Name
usdz- Type
- string
- Description
Le fichier USDZ.
- Name
mtl- Type
- string
- Description
Le fichier MTL, renvoyé avec le fichier OBJ lorsque le modèle possède des textures.
- Name
stl- Type
- string
- Description
Le fichier STL.
- Name
3mf- Type
- string
- Description
Le fichier 3MF. Présent uniquement lorsque
target_formatsinclut3mf.
- Name
pre_remeshed_glb- Type
- string
- Description
Le fichier GLB d'avant le remaillage. Présent uniquement lorsque vous avez créé la tâche avec à la fois
should_remesh: trueetsave_pre_remeshed_model: true.
- Name
- thumbnail_url
- Type
- string
- Description
URL de téléchargement pour une image d'aperçu du modèle. C'est la même que
thumbnail_urls.frontlorsque ce champ est présent.
- Name
- alpha_thumbnail_url
- Type
- string
- Description
URL de téléchargement pour une version de
thumbnail_urlavec un fond transparent (RGBA). Présente uniquement lorsque vous avez créé la tâche avecalpha_thumbnail: trueet que Meshy a rendu l'aperçu transparent.
- Name
- thumbnail_urls
- Type
- object
- Description
URLs de téléchargement pour des aperçus du modèle 3D sous quatre angles. Chacune est une URL signée vers un PNG 512×512, rendu avec les mêmes matériaux et le même éclairage que
thumbnail_url. Vous pouvez les utiliser pour prévisualiser le modèle sous plusieurs angles sans télécharger le GLB.Présent uniquement lorsque vous avez créé la tâche avec
multi_view_thumbnails: trueet que la tâche a atteintSUCCEEDED. Une tâche créée sansmulti_view_thumbnails: truen'a pas ce champ.- Name
- front
- Type
- string
- Description
La vue de face, à 0° autour de l'axe vertical. Elle correspond à
thumbnail_url.
- Name
- right
- Type
- string
- Description
La vue de droite, à 90°.
- Name
- back
- Type
- string
- Description
La vue arrière, à 180°.
- Name
- left
- Type
- string
- Description
La vue de gauche, à 270°.
- Name
- texture_prompt
- Type
- string
- Description
Le prompt textuel qui a guidé la texture.
- Name
- texture_image_urls
- Type
- string[]
- Description
URLs de téléchargement pour les images de référence de texture avec lesquelles vous avez créé la tâche, dans l'ordre où vous les avez envoyées. Présent uniquement lorsque vous avez créé la tâche avec
texture_image_urls.
- Name
- ultra_mode
- Type
- boolean
- ⚠ obsolète
- Description
Consultez plutôt
geometry_resolution.
- Name
- geometry_resolution
- Type
- string
- Description
Le palier Ultra sur lequel la tâche s'est exécutée, à savoir
2k. Une tâchestandardn'a pas ce champ.
- Name
- progress
- Type
- integer
- Description
La part de la tâche accomplie, en pourcentage. Elle vaut
0jusqu'à ce que la tâche démarre et100quand elle réussit.
- Name
- started_at
- Type
- timestamp
- Description
Heure de démarrage de la tâche, en millisecondes Unix. Elle vaut
0jusqu'à ce que la tâche démarre.
- Name
- created_at
- Type
- timestamp
- Description
Heure de création de la tâche, en millisecondes Unix.
- Name
- expires_at
- Type
- timestamp
- Description
Heure d'expiration des résultats de la tâche, en millisecondes Unix.
- Name
- finished_at
- Type
- timestamp
- Description
Heure de fin de la tâche, en millisecondes Unix. Elle vaut
0jusqu'à ce que la tâche se termine.
- Name
- status
- Type
- string
- Description
Le statut de la tâche, l'un de
PENDING,IN_PROGRESS,SUCCEEDED,FAILEDouCANCELED.
- Name
- texture_urls
- Type
- array
- Description
URLs de téléchargement pour les cartes de texture générées par la tâche, sous forme de tableau d'objets. Il contient généralement un seul objet. Chaque objet possède ces champs :
- Name
base_color- Type
- string
- Description
La carte de couleur de base.
- Name
metallic- Type
- string
- Description
La carte métallique. Non incluse lorsque vous avez créé la tâche avec
enable_pbr: false.
- Name
normal- Type
- string
- Description
La normal map. Non incluse lorsque vous avez créé la tâche avec
enable_pbr: false.
- Name
roughness- Type
- string
- Description
La carte de rugosité. Non incluse lorsque vous avez créé la tâche avec
enable_pbr: false.
- Name
emission- Type
- string
- Description
La carte d'émission. Incluse uniquement lorsque vous avez créé la tâche avec tous les éléments suivants :
ai_model: meshy-6, avec son modèle de texture par défautenable_pbr: true- une
texture_resolutionde2kou4k
- Name
- preceding_tasks
- Type
- integer
- Description
Le nombre de tâches devant celle-ci dans la file d'attente. La valeur n'est pertinente que tant que la tâche est
PENDING.
- Name
- task_error
- Type
- object
- Description
Les détails de l'erreur en cas d'échec de la tâche. Elle vaut
nullsauf si le statut estFAILED. Voir Erreurs.
- Name
- consumed_credits
- Type
- integer
- Description
Le nombre de crédits utilisés par la tâche. Présent lorsque le statut est
PENDING,IN_PROGRESSouSUCCEEDED. Il vaut0pour une tâcheFAILED, car Meshy rembourse les crédits lorsqu'une tâche échoue.