lowpoly sera retiré le 30 oct. 2026. Changez de modèle avant ces dates pour éviter les erreurs de requête. Voir toutes les dépréciations

API Analyser l'imprimabilité

Vérifiez un modèle 3D pour détecter d'éventuels problèmes d'impression en mesurant son étanchéité, son volume, ses trous, ses arêtes non-manifold et ses faces dégénérées. Vous pouvez également vérifier l'épaisseur de paroi à la taille à laquelle vous prévoyez d'imprimer.


POST/openapi/v1/print/analyze

Créer une tâche Analyser l'imprimabilité

Crée une tâche Analyser l'imprimabilité, qui évalue un modèle 3D et fournit ses métriques d'imprimabilité. 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.

Lorsque Meshy possède déjà le résultat d'imprimabilité pour la tâche input_task_id, la nouvelle tâche est prête immédiatement. Votre premier GET sur celle-ci renvoie le résultat.

Request

POST
/openapi/v1/print/analyze
# Analyze an existing task
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or analyze a model URL directly
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.glb"
  }'

# Also check wall thickness for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/analyze \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

Paramètres

  • Name
    input_task_id
    Type
    string
    Requis
    Description

    Requis sauf si vous envoyez model_url. L'ID de la tâche dont vous souhaitez analyser le modèle. La tâche doit avoir le statut SUCCEEDED, et vous appartenir ou appartenir à un espace de travail dont vous êtes membre.

    Il peut s'agir de l'un de ces types de tâches, utilisant Meshy 6 ou une version plus récente, y compris Meshy 7 :

    Une tâche Réparer l'imprimabilité fonctionne également.

  • Name
    model_url
    Type
    string
    Requis
    Description

    Requis sauf si vous envoyez input_task_id. Le modèle à analyser, sous forme d'URL publique ou de Data URI. Si vous envoyez les deux, Meshy utilise input_task_id.

    Depuis une URL http ou https, le modèle doit être un fichier .glb, .gltf, .obj, .fbx, ou .stl de 400 Mo maximum. Un Data URI ne peut contenir qu'un fichier GLB encodé en base64 (data:model/gltf-binary;base64,...) ou glTF (data:model/gltf+json;base64,...) de 100 Mo maximum. Envoyez un fichier .obj, .fbx, ou .stl sous forme d'URL http ou https.

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

    • Un fichier GLB, glTF, FBX ou OBJ peut comporter au maximum 10 000 000 faces. Meshy compte les faces comme des 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.

    Une URL de téléchargement Meshy (assets.meshy.ai/…?Expires=…&Signature=…) est signée et cesse de fonctionner à la date expires_at de sa tâche. Relire la tâche ne la renouvelle pas. Pour un modèle que vous avez créé avec Meshy, envoyez plutôt input_task_id, qui fonctionne tant que Meshy conserve la tâche source (voir Conservation des ressources). Pour utiliser le modèle après cela, téléchargez-le avant expires_at et envoyez votre propre copie.

Pour également vérifier l'épaisseur de paroi à la taille d'impression prévue, envoyez printer_type, une taille d'impression, ou les deux. Le résultat se trouve dans printability.thin_walls. La vérification de l'épaisseur de paroi prend plus de temps, donc la tâche n'est généralement pas prête immédiatement, même si Meshy a déjà analysé le modèle auparavant.

  • Name
    printer_type
    Type
    string
    Description

    L'imprimante que vous prévoyez d'utiliser. Elle définit l'épaisseur de paroi minimale pour la vérification de l'épaisseur de paroi. Si vous envoyez une taille d'impression sans printer_type, Meshy utilise fdm.

    Valeurs disponibles :

    • fdm : filament, paroi minimale de 1,0 mm
    • sla : résine, paroi minimale de 0,8 mm
    • full_color : couleur complète, paroi minimale de 2,0 mm

    Toute autre valeur renvoie 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    La hauteur de l'impression, en millimètres, de 1 à 1000. Une valeur hors de cette plage renvoie 400. Envoyez ceci ou intended_print_longest_side_mm, pas les deux.

    Cela fonctionne uniquement avec une entrée GLB. Pour un model_url qui n'est pas un fichier .glb, envoyez plutôt intended_print_longest_side_mm.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    La longueur du côté le plus long de l'impression, en millimètres, de 1 à 1000. Une valeur hors de cette plage renvoie 400. Cela fonctionne avec tous les formats d'entrée.

Si vous envoyez printer_type sans taille, Meshy utilise cette taille d'impression :

  • fichier .glb ou tout input_task_id : 150 mm de hauteur
  • fichier .stl : le côté le plus long propre au fichier, lu en millimètres
  • fichier .obj, .fbx, ou .gltf : 150 mm sur le côté le plus long

Pour un fichier STL dans d'autres unités, envoyez intended_print_longest_side_mm.

Meshy arrondit les deux tailles d'impression au millimètre le plus proche.

Retours

Le champ result de la réponse contient l'ID de la nouvelle tâche Analyser l'imprimabilité.

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 rencontré. Par exemple :

    • Paramètre manquant : ni input_task_id ni model_url n'a été envoyé.
    • UUID invalide : input_task_id n'est pas un UUID valide.
    • URL de modèle invalide : model_url est malformé, utilise un schéma non pris en charge, ou a une extension de fichier non prise en charge.
    • Fichier modèle trop volumineux : le fichier model_url fait plus de 400 Mo depuis une URL http ou https, ou plus de 100 Mo en tant que Data URI.
    • Trop de faces : le fichier model_url est un fichier GLB, glTF, FBX, ou OBJ de plus de 100 Mo avec 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 modèle illisible : le fichier model_url fait plus de 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 du modèle trop complexe : le fichier model_url fait plus de 100 Mo, et son en-tête contient trop de maillages, de nœuds, ou d'enregistrements à vérifier. Réduisez le nombre d'objets dans le fichier, puis renvoyez-le.
    • Le fichier modèle ne peut pas être téléchargé : model_url a renvoyé une erreur, le plus souvent parce qu'une URL de téléchargement Meshy signée a expiré. Relire la tâche renvoie la même URL avec la même date d'expiration. Envoyez votre propre copie du fichier, ou envoyez input_task_id tant que Meshy conserve la tâche source.
    • Tâche non réussie : la tâche input_task_id est encore en attente, en cours, ou a échoué.
    • Taille d'impression invalide : intended_print_height_mm ou intended_print_longest_side_mm est en dehors de la plage 1 à 1000, ou la requête contient les deux.
    • Type d'imprimante inconnu : printer_type n'est ni fdm, ni sla, ni full_color.
    • Hauteur sur un modèle non-GLB : la requête contient intended_print_height_mm et un model_url qui n'est pas un fichier .glb. Envoyez plutôt intended_print_longest_side_mm.
    • Impossible de dimensionner ce modèle par la hauteur : à la hauteur demandée, ou à la valeur par défaut de 150 mm, le côté le plus long du modèle serait en dehors de la plage 1 à 1 000 mm. Cela se produit également lorsque le modèle est plat, ou lorsque Meshy ne peut pas déterminer sa taille. Envoyez plutôt intended_print_longest_side_mm. Pour un model_url au format .glb et certaines tâches input_task_id, Meshy ne le détecte qu'après le démarrage de la tâche, et la tâche se termine alors en FAILED.
    • Taille STL inutilisable : la requête contient printer_type sans taille, et Meshy ne peut pas lire le côté le plus long propre au fichier .stl, ou celui-ci est en dehors de la plage 1 à 1 000 mm. Envoyez intended_print_longest_side_mm.

    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
    403 - Forbidden
    Description

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

  • Name
    404 - Not Found
    Description

    Meshy ne trouve aucun modèle à analyser pour input_task_id. Par exemple :

    • La tâche n'existe pas, a été supprimée, ou ne vous appartient pas ou n'appartient pas à un espace de travail dont vous êtes membre.
    • La tâche utilise un modèle antérieur à Meshy 6, ou son type ne produit pas de modèle 3D.
    • Le fichier modèle de la tâche n'est plus dans le stockage.

    Vérifiez que input_task_id est une tâche prise en charge qui vous appartient ou appartient à l'un de vos espaces de travail, ou envoyez le modèle en tant que model_url.

  • Name
    429 - Too Many Requests
    Description

    Vous avez dépassé votre limite de débit, ou vous avez trop de tâches en attente. Patientez, puis réessayez. Consultez Limites de débit.


GET/openapi/v1/print/analyze/:id

Récupérer une tâche d'analyse de l'imprimabilité

Renvoie une tâche d'analyse de l'imprimabilité par son ID.

Request

GET
/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}

Paramètres

  • Name
    id
    Type
    path
    Description

    L'ID de la tâche provenant de la réponse de création.

Retours

L'objet tâche d'analyse de l'imprimabilité. Son champ printability n'est présent que lorsque la tâche est SUCCEEDED. Lorsque Meshy a vérifié l'épaisseur de paroi, printability inclut également intended_print et thin_walls.


DELETE/openapi/v1/print/analyze/:id

Supprimer une tâche Analyser l'imprimabilité

Supprime définitivement une tâche Analyser l'imprimabilité, y compris son résultat mis en cache. Vous ne pouvez pas annuler une suppression.

Request

DELETE
/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -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 coûterait à 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/print/analyze

Lister les tâches Analyser l'imprimabilité

Renvoie une liste de vos tâches Analyser l'imprimabilité.

Request

GET
/openapi/v1/print/analyze
curl https://api.meshy.ai/openapi/v1/print/analyze?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-analyze",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000001000,
    "expires_at": 1715725401000,
    "task_error": null,
    "printability": {
      "_version": "v1",
      "status": "warning",
      "issue_count": 1,
      "error_count": 0,
      "warning_count": 1,
      "metrics": {
        "is_watertight": true,
        "volume": 1.316167354292668,
        "non_manifold_edges": 0,
        "degenerate_faces": 43242,
        "holes": 0
      },
      "evaluated_at": 1700000001000
    },
    "consumed_credits": 0
  }
]

Paramètres

  • Name
    page_num
    Type
    integer
    défaut 1
    Description

    Le numéro de page à renvoyer, en commençant à 1.

  • 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 Analyser l'imprimabilité.


GET/openapi/v1/print/analyze/:id/stream

Diffuser une tâche Analyser l'imprimabilité en flux

Diffuse les mises à jour d'une tâche Analyser l'imprimabilité sous forme d'événements envoyés par le serveur (SSE).

Request

GET
/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream
curl -N https://api.meshy.ai/openapi/v1/print/analyze/a43b5c6d-7e8f-901a-234b-567c890d1e2f/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.
// Every frame is the full task object; fields not yet populated are null / empty.
// The following PENDING frame is abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

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 Analyser l'imprimabilité sous forme d'événements envoyés par le serveur.

Chaque événement contient l'objet de tâche complet, dans le 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 sortie sont vides (null, [], ou {}), et finished_at vaut 0. Meshy n'envoie le champ printability qu'une fois la tâche SUCCEEDED.


L'objet tâche Analyser l'imprimabilité

Un objet tâche Analyser l'imprimabilité décrit une analyse d'un modèle 3D. Il contient le statut, la progression et le résultat d'imprimabilité lorsque la tâche réussit.

The Analyze Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000001000,
  "expires_at": 1715725401000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "warning",
    "issue_count": 1,
    "error_count": 0,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "evaluated_at": 1700000001000
  },
  "consumed_credits": 0
}

The Analyze Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-analyze",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000012000,
  "expires_at": 1715725412000,
  "task_error": null,
  "printability": {
    "_version": "v1",
    "status": "error",
    "issue_count": 2,
    "error_count": 1,
    "warning_count": 1,
    "metrics": {
      "is_watertight": true,
      "volume": 1.316167354292668,
      "non_manifold_edges": 0,
      "degenerate_faces": 43242,
      "holes": 0
    },
    "intended_print": {
      "printer_type": "sla",
      "height_mm": 100,
      "longest_side_mm": 118,
      "wall_thickness_mm": 0.8,
      "dimensions_mm": [118, 72.41, 99.87]
    },
    "thin_walls": {
      "thin_area_ratio": 0.083,
      "has_thin_walls": true,
      "status": "error"
    },
    "evaluated_at": 1700000012000
  },
  "consumed_credits": 0
}
  • 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 print-analyze.

  • Name
    status
    Type
    string
    Description

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

  • Name
    progress
    Type
    integer
    Description

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

  • Name
    preceding_tasks
    Type
    integer
    Description

    Le nombre de tâches qui précèdent celle-ci dans la file d'attente. La valeur n'a de sens que pendant que la tâche est PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

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

  • Name
    started_at
    Type
    timestamp
    Description

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

  • Name
    finished_at
    Type
    timestamp
    Description

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

  • Name
    expires_at
    Type
    timestamp
    Description

    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.

  • Name
    task_error
    Type
    object
    Description

    Les détails de l'erreur lorsque la tâche échoue. C'est null si la tâche n'a pas échoué. Voir Erreurs.

    • Name
      message
      Type
      string
      Description

      Une description de ce qui s'est mal passé.

  • Name
    printability
    Type
    object
    Description

    Le résultat de l'analyse. Il n'est pas présent tant que la tâche n'est pas SUCCEEDED.

    • Name
      _version
      Type
      string
      Description

      La version de schéma du résultat d'imprimabilité. La valeur est v1.

    • Name
      status
      Type
      string
      Description

      Le verdict global, l'un de :

      • healthy : aucune erreur et aucun avertissement
      • warning : au moins un avertissement, et aucune erreur
      • error : au moins une erreur
      • unknown : Meshy n'a pas pu analyser le modèle

      Lorsque Meshy a vérifié l'épaisseur de paroi, il s'agit du pire résultat entre les vérifications du maillage et thin_walls.status. Du pire au meilleur, l'ordre est error, warning, unknown, et healthy.

    • Name
      issue_count
      Type
      integer
      Description

      Le nombre total de problèmes, égal à error_count + warning_count.

    • Name
      error_count
      Type
      integer
      Description

      Le nombre de problèmes de niveau erreur. Meshy compte une erreur pour chacun des cas suivants :

      • Le modèle n'est pas étanche (watertight) et comporte plus de 8 trous.
      • Le modèle comporte plus de 8 trous.
      • Le volume est nul ou négatif.
      • Le modèle comporte plus de 50 arêtes non-manifold.

      Lorsque Meshy a vérifié l'épaisseur de paroi, les parois trop fines (thin_walls.status est error) comptent pour une erreur supplémentaire.

    • Name
      warning_count
      Type
      integer
      Description

      Le nombre de problèmes de niveau avertissement. Meshy compte un avertissement pour chacun des cas suivants :

      • Le modèle n'est pas étanche (watertight) et comporte 8 trous ou moins.
      • Le modèle comporte de 1 à 8 trous.
      • Le modèle comporte de 1 à 50 arêtes non-manifold.
      • Le modèle comporte des faces dégénérées.
    • Name
      metrics
      Type
      object
      Description

      Les mesures brutes de géométrie du modèle.

      • Name
        is_watertight
        Type
        boolean
        Description

        true lorsque le maillage n'a aucune arête de bord, c'est-à-dire lorsqu'il est fermé.

      • Name
        volume
        Type
        number
        Description

        Le volume du modèle, en mètres cubes.

      • Name
        non_manifold_edges
        Type
        integer
        Description

        Le nombre d'arêtes non-manifold.

      • Name
        degenerate_faces
        Type
        integer
        Description

        Le nombre de faces dégénérées, c'est-à-dire des faces d'aire nulle ou des faces invalides.

      • Name
        holes
        Type
        integer
        Description

        Le nombre de trous dans le maillage, comptés comme des boucles de bord.

    • Name
      intended_print
      Type
      object
      Description

      L'imprimante et la taille utilisées par la vérification de l'épaisseur de paroi. Présent uniquement lorsque Meshy a vérifié l'épaisseur de paroi.

      • Name
        printer_type
        Type
        string
        Description

        Le type d'imprimante, fdm, sla, ou full_color.

      • Name
        height_mm
        Type
        number
        Description

        La hauteur d'impression, en millimètres, lorsque l'impression est dimensionnée par la hauteur. Sinon, c'est null.

      • Name
        longest_side_mm
        Type
        number
        Description

        La longueur du côté le plus long de l'impression, en millimètres. Lorsque l'impression est dimensionnée par la hauteur, Meshy la calcule à partir des proportions du modèle.

      • Name
        wall_thickness_mm
        Type
        number
        Description

        L'épaisseur de paroi minimale pour printer_type, en millimètres. Meshy signale les parois plus fines comme trop fines.

      • Name
        dimensions_mm
        Type
        array
        Description

        Les dimensions [largeur, profondeur, hauteur] de l'impression, en millimètres. La hauteur peut différer de height_mm d'une fraction de millimètre. C'est null pour une entrée autre que GLB, ou lorsque Meshy ne peut pas déterminer la taille du modèle.

    • Name
      thin_walls
      Type
      object
      Description

      Le résultat de la vérification de l'épaisseur de paroi. Présent uniquement lorsque Meshy a vérifié l'épaisseur de paroi.

      • Name
        thin_area_ratio
        Type
        number
        Description

        La part de la surface plus fine que intended_print.wall_thickness_mm, de 0 à 1. C'est null lorsque Meshy n'a pas pu mesurer le modèle.

      • Name
        has_thin_walls
        Type
        boolean
        Description

        true si une partie de la surface est trop fine. Des angles vifs à eux seuls peuvent le rendre true, donc utilisez status pour décider si les parois doivent être épaissies. C'est null lorsque Meshy n'a pas pu mesurer le modèle.

      • Name
        status
        Type
        string
        Description

        Le verdict d'épaisseur de paroi, l'un de :

        • healthy : 5 % ou moins de la surface est trop fine.
        • error : plus de 5 % de la surface est trop fine. Pour épaissir les parois, envoyez l'id de cette tâche à Réparer l'imprimabilité en tant que input_task_id. Si cette tâche a analysé un fichier .stl, .fbx, ou .gltf depuis model_url, envoyez plutôt ce fichier en tant que model_url.
        • unknown : Meshy n'a pas pu mesurer le modèle. Si la vérification de l'épaisseur de paroi elle-même échoue, la tâche se termine en FAILED.
    • Name
      evaluated_at
      Type
      timestamp
      Description

      Horodatage du calcul de l'analyse par Meshy, en millisecondes Unix.

  • Name
    consumed_credits
    Type
    integer
    Description

    Le nombre de crédits utilisés par la tâche. C'est toujours 0, car l'analyse est gratuite.