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 Réparer l'imprimabilité

Réparez un modèle 3D afin qu'il soit prêt à imprimer. Meshy corrige les arêtes non-manifold, les faces dégénérées, les trous et d'autres problèmes de topology. Vous pouvez également épaissir les parois trop fines pour la taille à laquelle vous prévoyez d'imprimer.


POST/openapi/v1/print/repair

Créer une tâche Réparer l'imprimabilité

Crée une tâche Réparer l'imprimabilité, qui répare la topologie d'un modèle 3D et renvoie une version étanche (watertight) prête à imprimer. 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.

Le modèle réparé a le même format que l'entrée. Par exemple, pour un fichier .stl dans model_url, model_urls.stl contient le maillage réparé, et model_urls ne contient aucune autre clé de format. Avec input_task_id, Meshy répare toujours le fichier GLB de la tâche source, donc la sortie est un fichier .glb.

Meshy supprime les textures du modèle pendant la réparation, car la géométrie change. Pour rajouter des textures, envoyez le modèle réparé à l'API Retexturisation.

Request

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

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

# Also thicken walls that are too thin for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/repair \
-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

    Obligatoire sauf si vous envoyez model_url. L'ID de la tâche dont vous voulez réparer le modèle, par exemple une tâche Image en 3D, Multi-image en 3D, Texte en 3D, Remaillage, Retexturisation, ou Analyser l'imprimabilité. La tâche doit être une tâche que vous avez créée avec l'API, avec le statut SUCCEEDED et un modèle GLB.

    Une tâche Analyser l'imprimabilité qui a vérifié l'épaisseur de paroi transmet aussi son imprimante et sa taille. La réparation vérifie alors l'épaisseur de paroi et épaissit les parois fines, même si vous n'envoyez ni l'un ni l'autre. Un printer_type ou une taille d'impression que vous envoyez remplace celui/celle de l'analyse. Une tâche Analyser l'imprimabilité d'un fichier .stl, .fbx ou .gltf provenant de model_url ne fonctionne pas. Envoyez plutôt ce fichier en tant que model_url.

  • Name
    model_url
    Type
    string
    Requis
    Description

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

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

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

    • Un fichier GLB, glTF, FBX ou OBJ peut avoir au plus 10 000 000 faces. Meshy compte les faces comme des triangles, donc un quad compte pour 2, et un maillage dessiné plusieurs fois compte une fois par copie.
    • Un fichier FBX doit être au format FBX binaire 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.

  • Name
    alpha_thumbnail
    Type
    boolean
    défaut false
    Description

    Indique si un aperçu avec fond transparent (RGBA) doit aussi être rendu, renvoyé dans alpha_thumbnail_url lorsque vous récupérez la tâche. thumbnail_url ne change pas.

Pour aussi épaissir les parois trop fines à la taille à laquelle vous prévoyez d'imprimer, envoyez printer_type, une taille d'impression, ou les deux. Meshy n'épaissit les parois que lorsque plus de 5 % de la surface est trop fine pour cette imprimante. Le modèle réparé conserve son échelle d'origine. Pour le redimensionner, utilisez l'API Redimensionner, qui prend des tailles en mètres, donc 100 mm correspond à 0.1.

  • Name
    printer_type
    Type
    string
    Description

    L'imprimante que vous prévoyez d'utiliser. Elle définit l'épaisseur de paroi minimale visée par la réparation. Si vous envoyez une taille d'impression sans printer_type, Meshy utilise fdm, sauf si une tâche Analyser l'imprimabilité dans input_task_id fournit l'imprimante.

    Valeurs disponibles :

    • fdm : filament, épaisseur de paroi minimale de 1,0 mm
    • sla : résine, épaisseur de paroi minimale de 0,8 mm
    • full_color : couleur intégrale, épaisseur de 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 ce paramètre ou intended_print_longest_side_mm, pas les deux.

    Il ne fonctionne qu'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 plus grand côté de l'impression, en millimètres, de 1 à 1000. Une valeur hors de cette plage renvoie 400. Il fonctionne avec tous les formats d'entrée.

Si vous envoyez printer_type sans taille, et que Meshy ne réutilise aucune taille provenant d'une tâche Analyser l'imprimabilité, Meshy utilise cette taille d'impression :

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

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.

Valeurs renvoyées

Le champ result de la réponse contient l'ID de la nouvelle tâche Réparer 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 trouvé. Par exemple :

    • Paramètre manquant : ni input_task_id ni model_url n'ont été envoyés.
    • UUID invalide : input_task_id n'est pas un UUID valide.
    • URL de modèle invalide : model_url est mal formée, utilise un schéma non pris en charge, ou a une extension de fichier non prise en charge.
    • Fichier de 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 en FBX binaire ou en GLB.
    • Fichier de 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 de 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 de 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 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é.
    • GLB manquant : la tâche input_task_id n'a aucun modèle GLB à réparer.
    • Taille d'impression invalide : intended_print_height_mm ou intended_print_longest_side_mm est en dehors de 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 aux 150 mm par défaut, le plus grand côté du modèle serait en dehors de 1 à 1 000 mm. Cela se produit aussi 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 détecte cela qu'après le démarrage de la tâche, et la tâche se termine alors avec le statut FAILED.
    • Taille STL inutilisable : la requête contient printer_type sans taille, et Meshy ne peut pas lire le plus grand côté propre au fichier .stl, ou celui-ci est en dehors de 1 à 1 000 mm. Envoyez intended_print_longest_side_mm.

    Corrigez la requête, puis renvoyez-la. Voir 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.
    • Forfait gratuit : la création d'une tâche nécessite un forfait payant. Mettez à niveau votre forfait dans vos paramètres d'abonnement, puis réessayez.
  • Name
    403 - Forbidden
    Description

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

  • Name
    404 - Not Found
    Description

    La tâche input_task_id n'existe pas ou appartient à un autre utilisateur. Vérifiez l'ID, et utilisez une clé API provenant du compte qui a créé la tâche.

  • 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. Voir Limites de débit.


GET/openapi/v1/print/repair/:id

Obtenir une tâche Réparer l'imprimabilité

Retourne une tâche Réparer l'imprimabilité par son ID.

Request

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}

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 Réparer l'imprimabilité. Son champ model_urls est vide jusqu'à ce que la tâche soit SUCCEEDED. Après cela, il ne contient que la clé correspondant au format d'entrée. Une réparation d'épaisseur de paroi inclut intended_print dès le début, et print_repair_report une fois la tâche terminée avec succès.


DELETE/openapi/v1/print/repair/:id

Supprimer une tâche Réparer l'imprimabilité

Supprime définitivement une tâche Réparer l'imprimabilité, y compris son modèle réparé. Vous ne pouvez pas annuler une suppression.

Request

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

Liste des tâches Réparer l'imprimabilité

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

Request

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-repair",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000030000,
    "expires_at": 1715725401000,
    "task_error": null,
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

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 Réparer l'imprimabilité.


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

Diffuser un flux pour une tâche Réparer l'imprimabilité

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

Request

GET
/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream
curl -N https://api.meshy.ai/openapi/v1/print/repair/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-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

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 Réparer 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. model_urls est un objet vide jusqu'à ce que la tâche soit SUCCEEDED.


L'objet tâche Réparer l'imprimabilité

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

The Repair Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

The Repair Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}
  • 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-repair.

  • 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 accomplie, en pourcentage. Elle vaut 0 jusqu'à ce que la tâche démarre et 100 lorsqu'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 tant que la tâche est PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

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

  • 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
    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
    expires_at
    Type
    timestamp
    Description

    Heure d'expiration du résultat de la tâche, en millisecondes Unix. Elle vaut 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. La valeur 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
    model_urls
    Type
    object
    Description

    URL de téléchargement pour le modèle réparé. Il ne contient que la clé correspondant au format d'entrée. 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 réparé. Défini lorsque l'entrée était un fichier GLB ou que vous avez envoyé input_task_id.

    • Name
      gltf
      Type
      string
      Description

      Le fichier glTF réparé. Défini lorsque l'entrée était un fichier glTF.

    • Name
      fbx
      Type
      string
      Description

      Le fichier FBX réparé. Défini lorsque l'entrée était un fichier FBX.

    • Name
      obj
      Type
      string
      Description

      Le fichier OBJ réparé. Défini lorsque l'entrée était un fichier OBJ.

    • Name
      stl
      Type
      string
      Description

      Le fichier STL réparé. Défini lorsque l'entrée était un fichier STL.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL de téléchargement pour une image d'aperçu du modèle réparé.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    URL de téléchargement pour une version de thumbnail_url avec un fond transparent (RGBA). Présent uniquement lorsque vous avez créé la tâche avec alpha_thumbnail: true et que Meshy a généré l'aperçu transparent.

  • Name
    texture_urls
    Type
    array
    Description

    Toujours un tableau vide. La réparation ne conserve que la géométrie d'entrée et ne recalcule pas les textures.

  • Name
    consumed_credits
    Type
    integer
    Description

    Le nombre de crédits utilisés par la tâche. Il vaut 10 lorsque la tâche est SUCCEEDED, et 0 pour une tâche FAILED, car Meshy rembourse les crédits lorsqu'une tâche échoue.

  • Name
    intended_print
    Type
    object
    Description

    L'imprimante et la taille utilisées par la réparation, que vous les ayez envoyées ou que Meshy les ait réutilisées depuis une tâche Analyser l'imprimabilité. Présent dès le début pour une réparation d'épaisseur de paroi, y compris tant que la tâche est PENDING. Une valeur que Meshy ne connaît pas encore vaut null.

    • 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, la valeur 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, et elle vaut null jusqu'à ce que Meshy mesure le modèle.

    • Name
      wall_thickness_mm
      Type
      number
      Description

      L'épaisseur de paroi minimale pour printer_type, en millimètres.

    • Name
      dimensions_mm
      Type
      array
      Description

      Les [largeur, profondeur, hauteur] de l'impression, en millimètres. La hauteur peut différer de height_mm d'une fraction de millimètre. Elle vaut null jusqu'à ce que la tâche réussisse, et toujours null pour une entrée autre que GLB.

  • Name
    print_repair_report
    Type
    object
    Description

    Ce que la réparation d'épaisseur de paroi a effectué. Présent une fois qu'une réparation d'épaisseur de paroi a réussi.

    • Name
      route
      Type
      string
      Description

      Quelle réparation a été exécutée, l'une de :

      • thin_wall : plus de 5 % de la surface était trop fine, donc l'épaississement des parois a également été exécuté. Pour voir si cela a modifié le maillage, vérifiez applied.
      • topology : les parois étaient suffisamment épaisses, donc seule la réparation de topology a été exécutée.
      • topology_unmeasured : Meshy n'a pas pu mesurer les parois, donc seule la réparation de topology a été exécutée.
    • Name
      applied
      Type
      boolean
      Description

      Indique si l'épaississement des parois a modifié le maillage. Présent uniquement lorsque route vaut thin_wall.

    • Name
      faces_before
      Type
      integer
      Description

      Le nombre de faces du maillage d'entrée. Présent uniquement lorsque route vaut thin_wall.

    • Name
      faces_after
      Type
      integer
      Description

      Le nombre de faces du maillage réparé. Présent uniquement lorsque route vaut thin_wall.

    • Name
      thin_area_ratio_before
      Type
      number
      Description

      La part de la surface d'entrée plus fine que intended_print.wall_thickness_mm, de 0 à 1. Omise lorsque Meshy n'a pas pu mesurer l'entrée.

    • Name
      thin_area_ratio_after
      Type
      number
      Description

      La même part, mesurée sur le modèle réparé. Omise lorsque Meshy n'a pas pu la mesurer. La tâche réussit tout de même.