lowpoly sera retiré le 30 oct. 2026. meshy-7 sera retiré en tant que modèle de génération 3D le 31 déc. 2026 ; il reste disponible en tant que modèle de texture. Changez de modèle avant ces dates pour éviter les erreurs de requête. Voir toutes les dépréciations

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.


POST/openapi/v1/multi-image-to-3d

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

POST
/openapi/v1/multi-image-to-3d
# 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 est SUCCEEDED.

  • 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, comme data:image/jpeg;base64,<vos données d'image encodées en base64>. Si vous envoyez les deux, Meshy utilise input_task_id.

    Chaque image doit être un fichier .jpg, .jpeg, .png ou .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). Plus de quatre images renvoie 400.

    Pour de meilleurs résultats, les images doivent montrer le même objet sous différents angles. Avec meshy-7.1 ou latest, 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.1
    • meshy-7.1
    • meshy-6
    • meshy-6-lite
    • meshy-7 : obsolète, envoyez meshy-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 :

    • standard
    • 2k : exécute la passe Ultra à 2048³. Nécessite meshy-7.1, latest, ou l'obsolète meshy-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. true renvoie un modèle texturé, et false saute l'étape de texture et renvoie un maillage sans textures.

S'applique uniquement quand 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'à 8K
    • meshy-n1 : Meshy N1, une texture de couleur de base en 2K uniquement à partir d'images de référence

    Chaque ai_model accepte les deux. Une requête texturée avec meshy-6 ou meshy-6-lite renvoie 400, tout comme une option que le modèle de texture choisi ne prend pas en charge. Avec should_texture: false, Meshy ignore texture_model, mais une valeur inconnue renvoie quand même 400.

    Avec meshy-n1, Meshy texture à partir de texture_image_urls ou texture_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. Avec texture_model: meshy-n1, true renvoie 400.

  • 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×2048
    • 4k : 4096×4096
    • 8k : 8192×8192

    4k et 8k nécessitent le modèle de texture Meshy 7 ou Meshy 6, et renvoient 400 avec 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 utilise texture_resolution.

  • Name
    texture_prompt
    Type
    string
    Description

    Texte qui guide la texture, jusqu'à 800 caractères. Un texte plus long renvoie 400. Avec texture_model: meshy-n1, l'envoyer renvoie 400.

  • 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, .png ou .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).

    Si vous envoyez à la fois texture_image_url et texture_prompt, Meshy utilise texture_prompt. Avec texture_model: meshy-n1, Meshy texture à partir de cette image comme vue de face.

  • 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, .png ou .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_urls nécessite le modèle de texture Meshy 7 ou Meshy N1. Envoyez-le avec l'un de ces éléments :

    • ai_model de meshy-7.1, latest, ou l'obsolète meshy-7
    • texture_model de meshy-7 ou meshy-n1

    Vous ne pouvez pas l'envoyer avec texture_image_url ou texture_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.

S'applique uniquement quand 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ères
    • triangle : un maillage triangulaire décimé

    Avec texture_model: meshy-n1, quad renvoie 400 lorsque le modèle est remaillé, ce que meshy-6-lite fait 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 renvoie 400.

  • Name
    decimation_mode
    Type
    integer
    Description

    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
  • 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étrie
    • auto : symétrie basée sur la géométrie d'entrée
    • on : symétrie imposée
  • Name
    pose_mode
    Type
    string
    Description

    La pose d'un modèle de personnage, a-pose ou t-pose. Pour n'avoir aucune pose, omettez pose_mode et is_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. false conserve l'aspect exact des images d'entrée, sans traitement de style. Pris en charge uniquement avec meshy-6, meshy-7.1, ou latest. L'envoyer avec meshy-6-lite renvoie 400.

  • 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: 8k il retire toujours l'éclairage. Avec texture_model: meshy-n1, true renvoie 400. Avec ai_model: meshy-6-lite et son modèle de texture par défaut, l'envoyer renvoie 400.

  • 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_url ou chaque image de texture_image_urls, et le texte de texture_prompt. Si Meshy trouve du contenu nuisible, la requête renvoie 400 et 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 :

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

    Si vous l'omettez, Meshy génère tous les formats sauf 3mf. Meshy génère 3mf uniquement 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.

S'applique uniquement quand auto_size = true
  • Name
    origin_at
    Type
    string
    défaut bottom
    Description

    Où placer l'origine du modèle, bottom ou center.

  • 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_url lorsque vous récupérez la tâche. thumbnail_url ne 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_urls lorsque vous récupérez la tâche. thumbnail_url ne 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_urls ni input_task_id n'a été envoyé.
    • Tâche d'entrée invalide : input_task_id n'est pas une tâche Texte en image ou Image en image au statut SUCCEEDED, ni une tâche multi-vue.
    • Nombre d'images invalide : image_urls ou texture_image_urls ne contient pas de 1 à 4 images.
    • Format d'image invalide : une image dans image_urls n'est pas dans un format pris en charge.
    • Entrées de texture en conflit : texture_image_urls a été envoyé avec texture_image_url, avec texture_prompt, ou avec should_texture: false.
    • Modèle non pris en charge pour la texture multi-vue : texture_image_urls a été envoyé avec ai_model de meshy-6 ou meshy-6-lite, sauf si texture_model est meshy-7 ou meshy-n1.
    • URL inaccessible : Meshy ne peut pas télécharger une image dans image_urls ou texture_image_urls.
    • Image trop grande : une image dans image_urls, texture_image_url, ou texture_image_urls dépasse 20 Mo.
    • Taille d'image invalide : une image dans image_urls, texture_image_url, ou texture_image_urls a 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_resolution est "4k", ce que ce point de terminaison ne prend pas en charge. Utilisez 2k ou standard.
    • Modèle non pris en charge pour les options d'image : image_enhancement a été envoyé avec ai_model: "meshy-6-lite", ou remove_lighting a été envoyé avec ai_model: "meshy-6-lite" et son modèle de texture par défaut.
    • Modèle de texture invalide : texture_model n'est pas un nom de modèle de texture valide.
    • Modèle de texture non disponible : une requête texturée a envoyé texture_model de meshy-6 ou meshy-6-lite. Multi-image en 3D n'accepte que les modèles de texture qui texturent à partir de plusieurs vues. Envoyez meshy-7 ou meshy-n1, ou omettez texture_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: true avec meshy-n1 ou une texture 4k avec meshy-6-lite. Consultez Modèles.

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

  • 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_id ne 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.


GET/openapi/v1/multi-image-to-3d/:id

Récupérer une tâche Multi-image en 3D

Renvoie une tâche Multi-image en 3D à partir de son ID.

Request

GET
/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578
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

L'objet tâche Multi-image en 3D.


DELETE/openapi/v1/multi-image-to-3d/:id

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

DELETE
/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578
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.


GET/openapi/v1/multi-image-to-3d

Liste des tâches Multi-image en 3D

Renvoie une liste de vos tâches Multi-image en 3D.

Request

GET
/openapi/v1/multi-image-to-3d
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 renvoie 400.

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


GET/openapi/v1/multi-image-to-3d/:id/stream

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

GET
/openapi/v1/multi-image-to-3d/018a210d-8ba4-705c-b111-1f1776f7f578/stream
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_formats inclut 3mf.

    • 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: true et save_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.front lorsque ce champ est présent.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    URL de téléchargement pour une version de thumbnail_url avec un fond transparent (RGBA). Présente uniquement lorsque vous avez créé la tâche avec alpha_thumbnail: true et 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: true et que la tâche a atteint SUCCEEDED. Une tâche créée sans multi_view_thumbnails: true n'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âche standard n'a pas ce champ.

  • Name
    progress
    Type
    integer
    Description

    La part de la tâche accomplie, en pourcentage. Elle vaut 0 jusqu'à ce que la tâche démarre et 100 quand elle réussit.

  • Name
    started_at
    Type
    timestamp
    Description

    Heure de démarrage de la tâche, en millisecondes Unix. Elle vaut 0 jusqu'à 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 0 jusqu'à 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, FAILED ou CANCELED.

  • 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éfaut
      • enable_pbr: true
      • une texture_resolution de 2k ou 4k
  • 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 null sauf si le statut est FAILED. 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_PROGRESS ou SUCCEEDED. Il vaut 0 pour une tâche FAILED, car Meshy rembourse les crédits lorsqu'une tâche échoue.