lowpoly буде вимкнено 30 жовт. 2026 р.. Перейдіть на іншу модель до цих дат, щоб уникнути помилок у запитах. Усі застарілі функції

Repair Printability API

Відновіть 3D-модель, щоб вона була готова до друку. Meshy виправляє немноговидні ребра, вироджені грані, отвори та інші проблеми з topology. Ви також можете потовщити стінки, які занадто тонкі для розміру, в якому ви плануєте друкувати.


POST/openapi/v1/print/repair

Create a Repair Printability task

Створює завдання Відновлення придатності до друку, яке відновлює топологію 3D-моделі та повертає водонепроникну версію, готову до друку. Завдання виконується у фоновому режимі. Про типову тривалість виконання завдання див. Час обробки.

Відновлена модель має той самий формат, що й вхідна. Наприклад, для файлу .stl у model_url, model_urls.stl міститиме відновлену сітку, а model_urls не матиме інших ключів формату. З input_task_id Meshy завжди відновлює файл GLB вихідного завдання, тож результатом буде файл .glb.

Під час відновлення Meshy видаляє текстури моделі, оскільки геометрія змінюється. Щоб повернути текстури, надішліть відновлену модель до Retexture API.

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"
}

Параметри

  • Name
    input_task_id
    Type
    string
    Обов'язковий
    Description

    Обов’язковий, якщо не надіслано model_url. ID завдання, модель якого потрібно відновити, наприклад завдання Зображення у 3D, Мульти-зображення у 3D, Текст у 3D, Ремеш, Ретекстурування або Аналіз придатності до друку. Завдання має бути створене вами через API, мати статус SUCCEEDED і містити модель GLB.

    Завдання Аналізу придатності до друку, яке перевіряло товщину стінки, також передає свій принтер і розмір. Відновлення тоді перевіряє товщину стінки й потовщує тонкі стінки, навіть якщо ви не надішлете жодного з цих параметрів. printer_type або розмір друку, надіслані вами, замінюють значення з аналізу. Завдання Аналізу придатності до друку для файлу .stl, .fbx або .gltf з model_url не працює. Замість цього надішліть цей файл як model_url.

  • Name
    model_url
    Type
    string
    Обов'язковий
    Description

    Обов’язковий, якщо не надіслано input_task_id. Модель для відновлення, у вигляді публічної URL-адреси або data URI. Якщо надіслано обидва, Meshy використовує input_task_id.

    З URL-адреси http або https модель має бути файлом .glb, .gltf, .obj, .fbx або .stl розміром не більше 400 МБ. Data URI може містити лише файл GLB у base64 (data:model/gltf-binary;base64,...) або glTF (data:model/gltf+json;base64,...) розміром не більше 100 МБ. Файл .obj, .fbx або .stl надсилайте як URL-адресу http або https.

    Файл понад 100 МБ також має відповідати цим правилам:

    • Файл GLB, glTF, FBX або OBJ може мати не більше 10 000 000 граней. Meshy рахує грані як трикутники, тож чотирикутник рахується за 2, а сітка, намальована кілька разів, рахується один раз за кожну копію.
    • Файл FBX має бути бінарним FBX версії 7.1 або новішої.
    • Файл GLB або glTF не повинен використовувати стиснення Draco.

    URL-адреса завантаження Meshy (assets.meshy.ai/…?Expires=…&Signature=…) підписана й перестає працювати після expires_at свого завдання. Повторне читання завдання не оновлює її. Для моделі, створеної у Meshy, натомість надішліть input_task_id, який працює, поки Meshy зберігає вихідне завдання (див. Зберігання ресурсів). Щоб використати модель після цього, завантажте її до настання expires_at і надішліть власну копію.

  • Name
    alpha_thumbnail
    Type
    boolean
    за замовчуванням false
    Description

    Чи потрібно також рендерити попередній перегляд із прозорим фоном (RGBA), який повертається в alpha_thumbnail_url під час отримання завдання. thumbnail_url не змінюється.

Щоб також потовщити стінки, які надто тонкі для розміру, у якому ви плануєте друкувати, надішліть printer_type, розмір друку або обидва. Meshy потовщує стінки лише тоді, коли понад 5% поверхні надто тонке для цього принтера. Відновлена модель зберігає свій початковий масштаб. Щоб змінити масштаб, скористайтеся Resize API, який приймає розміри в метрах, тож 100 мм — це 0.1.

  • Name
    printer_type
    Type
    string
    Description

    Принтер, який ви плануєте використовувати. Він задає мінімальну товщину стінки, до якої прагне відновлення. Якщо ви надішлете розмір друку без printer_type, Meshy використовує fdm, якщо тільки завдання Аналізу придатності до друку в input_task_id не надає принтер.

    Доступні значення:

    • fdm: філамент, мінімальна товщина стінки 1,0 мм
    • sla: смола, мінімальна товщина стінки 0,8 мм
    • full_color: повнокольоровий, мінімальна товщина стінки 2,0 мм

    Будь-яке інше значення повертає 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    Висота друку в міліметрах, від 1 до 1000. Значення поза діапазоном повертає 400. Надішліть цей параметр або intended_print_longest_side_mm, не обидва.

    Працює лише з вхідними даними GLB. Для model_url, який не є файлом .glb, натомість надішліть intended_print_longest_side_mm.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    Довжина найдовшої сторони друку в міліметрах, від 1 до 1000. Значення поза діапазоном повертає 400. Працює з будь-яким вхідним форматом.

Якщо ви надішлете printer_type без розміру, і Meshy не використовує жодного розміру із завдання Аналізу придатності до друку, Meshy використовує такий розмір друку:

  • файл .glb або будь-який input_task_id: висота 150 мм
  • файл .stl: власна найдовша сторона файлу, прочитана як міліметри
  • файл .obj, .fbx або .gltf: 150 мм на найдовшій стороні

Для файлу STL в інших одиницях вимірювання надішліть intended_print_longest_side_mm.

Meshy округлює обидва розміри друку до найближчого міліметра.

Що повертається

Поле result у відповіді містить ID нового завдання Відновлення придатності до друку.

Режими збою

  • Name
    400 - Bad Request
    Description

    Запит не може бути виконаний. Повідомлення про помилку вказує, яку проблему виявлено. Наприклад:

    • Відсутній параметр: не надіслано ні input_task_id, ні model_url.
    • Недійсний UUID: input_task_id не є дійсним UUID.
    • Недійсна URL-адреса моделі: model_url має неправильний формат, використовує непідтримувану схему або має непідтримуване розширення файлу.
    • Файл моделі завеликий: файл model_url перевищує 400 МБ з URL-адреси http або https, або перевищує 100 МБ як data URI.
    • Забагато граней: файл model_url — це файл GLB, glTF, FBX або OBJ розміром понад 100 МБ з більш ніж 10 000 000 граней. Зменшіть кількість граней, потім надішліть файл знову.
    • ASCII FBX понад 100 МБ: файл model_url — це ASCII FBX розміром понад 100 МБ. Надішліть його як бінарний FBX або GLB.
    • Нечитабельний файл моделі: файл model_url перевищує 100 МБ, і Meshy не може прочитати його заголовок. Наприклад, це GLB або glTF зі стисненням Draco, або бінарний FBX старіший за 7.1.
    • Заголовок моделі надто складний: файл model_url перевищує 100 МБ, і його заголовок містить забагато сіток, вузлів або записів для перевірки. Зменшіть кількість об’єктів у файлі, потім надішліть його знову.
    • Файл моделі неможливо завантажити: model_url повернув помилку, найчастіше через те, що підписана URL-адреса завантаження Meshy стала недійсною. Повторне читання завдання повертає ту саму URL-адресу з тим самим терміном дії. Надішліть власну копію файлу або надішліть input_task_id, поки Meshy зберігає вихідне завдання.
    • Завдання не завершено успішно: завдання input_task_id ще очікує, виконується або завершилося невдало.
    • Відсутній GLB: завдання input_task_id не містить моделі GLB для відновлення.
    • Недійсний розмір друку: intended_print_height_mm або intended_print_longest_side_mm виходить за межі діапазону від 1 до 1000, або запит містить обидва параметри.
    • Невідомий тип принтера: printer_type не є fdm, sla або full_color.
    • Висота для моделі, що не є GLB: запит містить intended_print_height_mm і model_url, який не є файлом .glb. Натомість надішліть intended_print_longest_side_mm.
    • Неможливо встановити розмір цієї моделі за висотою: за заданої висоти або стандартних 150 мм найдовша сторона моделі виходила б за межі діапазону від 1 до 1000 мм. Це також трапляється, коли модель плоска, або коли Meshy не може визначити її розмір. Натомість надішліть intended_print_longest_side_mm. Для model_url формату .glb та деяких завдань input_task_id Meshy виявляє це лише після початку завдання, і завдання завершується зі статусом FAILED замість цього.
    • Розмір STL непридатний для використання: запит містить printer_type без розміру, і Meshy не може прочитати власну найдовшу сторону файлу .stl, або вона виходить за межі діапазону від 1 до 1000 мм. Надішліть intended_print_longest_side_mm.

    Виправте запит, потім надішліть його знову. Див. Помилки.

  • Name
    401 - Unauthorized
    Description

    API-ключ відсутній або недійсний. Перевірте заголовок Authorization.

  • Name
    402 - Payment Required
    Description

    Наприклад:

    • Недостатньо кредитів: на рахунку недостатньо кредитів для цього завдання, або рахунок досяг ліміту кредитів. Перевірте баланс кредитів, потім повторіть спробу.
    • Безкоштовний план: для створення завдання потрібен платний план. Оновіть свій план у налаштуваннях підписки, потім повторіть спробу.
  • Name
    403 - Forbidden
    Description

    input_task_id — це модель барельєфу, яку ця кінцева точка не може відновити. Повідомлення: This model type does not support this operation. Надішліть іншу модель.

  • Name
    404 - Not Found
    Description

    Завдання input_task_id не існує або належить іншому користувачу. Перевірте ID і використовуйте API-ключ облікового запису, який створив завдання.

  • Name
    429 - Too Many Requests
    Description

    Ви перевищили обмеження частоти запитів, або у вас забагато завдань в очікуванні. Зачекайте, потім повторіть спробу. Див. Обмеження частоти.


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

Отримати завдання Відновлення придатності до друку

Повертає завдання Відновлення придатності до друку за його 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
  }
}

Параметри

  • Name
    id
    Type
    path
    Description

    ID завдання з відповіді на створення.

Повертає

Об'єкт завдання Відновлення придатності до друку. Його поле model_urls порожнє, доки завдання не отримає статус SUCCEEDED. Після цього воно містить лише ключ, що відповідає вхідному формату. Відновлення товщини стінки з самого початку містить intended_print, а після успішного завершення завдання — ще й print_repair_report.


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

Видалення завдання Відновлення придатності до друку

Остаточно видаляє завдання Відновлення придатності до друку, включно з відновленою моделлю. Видалення не можна скасувати.

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."
}

Параметри шляху

  • Name
    id
    Type
    path
    Description

    ID завдання, яке потрібно видалити.

Статус завдання

Видалення завдання зі статусом PENDING повертає кредити, витрачені під час його створення.

Завдання зі статусом IN_PROGRESS видалити не можна. Запит поверне 409 Conflict, а завдання продовжить виконуватися. Meshy не повертає кредити за завдання, яке вже почало виконуватися, тож видалення такого завдання коштувало б вам і кредитів, і результату. Дочекайтеся, поки воно досягне статусу SUCCEEDED, FAILED або CANCELED, і лише тоді видаляйте його.

Видалення завдання з кінцевим статусом (SUCCEEDED, FAILED або CANCELED) не повертає витрачені кредити.

Повертає

200 OK, коли завдання видалено, або 409 Conflict, коли завдання має статус IN_PROGRESS.


GET/openapi/v1/print/repair

Отримати список завдань на відновлення придатності до друку

Повертає список ваших завдань на Відновлення придатності до друку.

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
  }
]

Параметри

  • Name
    page_num
    Type
    integer
    за замовчуванням 1
    Description

    Номер сторінки, яку потрібно повернути, починаючи з 1.

  • Name
    page_size
    Type
    integer
    за замовчуванням 10
    Description

    Кількість завдань на сторінку, до 100.

  • Name
    sort_by
    Type
    string
    Description

    Порядок сортування.

    Доступні значення:

    • +created_at: спочатку найстаріші
    • -created_at: спочатку найновіші

Повертає

Список об'єктів завдань на Відновлення придатності до друку з пагінацією.


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

Потокова передача завдання Відновлення придатності до друку

Передає оновлення завдання Відновлення придатності до друку у вигляді Server-Sent Events (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
}

Параметри

  • Name
    id
    Type
    path
    Description

    ID завдання з відповіді на створення.

Повертає

Потік об'єктів завдання Відновлення придатності до друку у вигляді Server-Sent Events.

Кожна подія містить повний об'єкт завдання в тому ж форматі, що й повертає кінцева точка Get. Поки завдання має статус PENDING або IN_PROGRESS, його поля виводу порожні (null, [] або {}), а finished_at дорівнює 0. model_urls є порожнім об'єктом, доки завдання не отримає статус SUCCEEDED.


Об'єкт завдання Repair Printability

Об'єкт завдання Repair Printability описує одне відновлення 3D-моделі. Він містить статус, прогрес і відновлену модель, коли завдання завершується успішно.

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

    Ідентифікатор завдання. Сприймайте його як непрозорий рядок і не покладайтеся на його формат.

  • Name
    type
    Type
    string
    Description

    Тип завдання, завжди print-repair.

  • Name
    status
    Type
    string
    Description

    Статус завдання, один із PENDING, IN_PROGRESS, SUCCEEDED, FAILED або CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Наскільки виконано завдання, у відсотках. Дорівнює 0, доки завдання не почалося, і 100, коли воно успішно завершується.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Кількість завдань попереду цього у черзі. Значення має сенс лише поки завдання має статус PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

    Час створення завдання, у мілісекундах Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Час початку виконання завдання, у мілісекундах Unix. Дорівнює 0, доки завдання не почалося.

  • Name
    finished_at
    Type
    timestamp
    Description

    Час завершення завдання, у мілісекундах Unix. Дорівнює 0, доки завдання не завершиться.

  • Name
    expires_at
    Type
    timestamp
    Description

    Час, коли спливає термін дії результату завдання, у мілісекундах Unix. Дорівнює 0, доки завдання не завершиться.

  • Name
    task_error
    Type
    object
    Description

    Деталі помилки, якщо завдання завершилося невдало. Дорівнює null, якщо завдання не завершилося невдало. Див. Помилки.

    • Name
      message
      Type
      string
      Description

      Опис того, що пішло не так.

  • Name
    model_urls
    Type
    object
    Description

    URL-адреси для завантаження відновленої моделі. Містить лише ключ, що відповідає вхідному формату. Формат, який завдання не згенерувало, не має ключа, а не порожнього рядка.

    • Name
      glb
      Type
      string
      Description

      Відновлений файл GLB. Задається, коли вхідним файлом був GLB або ви надіслали input_task_id.

    • Name
      gltf
      Type
      string
      Description

      Відновлений файл glTF. Задається, коли вхідним файлом був glTF.

    • Name
      fbx
      Type
      string
      Description

      Відновлений файл FBX. Задається, коли вхідним файлом був FBX.

    • Name
      obj
      Type
      string
      Description

      Відновлений файл OBJ. Задається, коли вхідним файлом був OBJ.

    • Name
      stl
      Type
      string
      Description

      Відновлений файл STL. Задається, коли вхідним файлом був STL.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL-адреса для завантаження прев'ю-зображення відновленої моделі.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    URL-адреса для завантаження версії thumbnail_url із прозорим фоном (RGBA). Присутнє лише тоді, коли ви створили завдання з alpha_thumbnail: true і Meshy згенерував прозоре прев'ю.

  • Name
    texture_urls
    Type
    array
    Description

    Завжди порожній масив. Відновлення зберігає лише вхідну геометрію і не перезапікає текстури.

  • Name
    consumed_credits
    Type
    integer
    Description

    Кількість кредитів, витрачених завданням. Дорівнює 10, коли завдання має статус SUCCEEDED, і 0 для завдання зі статусом FAILED, оскільки Meshy повертає кредити, якщо завдання завершується невдало.

  • Name
    intended_print
    Type
    object
    Description

    Принтер і розмір, які використовувало відновлення — незалежно від того, чи надіслали ви їх самостійно, чи Meshy повторно використав їх із завдання Analyze Printability. Присутнє при відновленні товщини стінки з самого початку, включно з періодом, коли завдання має статус PENDING. Значення, яке Meshy ще не знає, дорівнює null.

    • Name
      printer_type
      Type
      string
      Description

      Тип принтера: fdm, sla або full_color.

    • Name
      height_mm
      Type
      number
      Description

      Висота друку, у міліметрах, коли розмір друку визначається висотою. Інакше дорівнює null.

    • Name
      longest_side_mm
      Type
      number
      Description

      Довжина найдовшої сторони друкованого об'єкта, у міліметрах. Коли розмір друку визначається висотою, Meshy обчислює це значення на основі пропорцій моделі, і воно дорівнює null, доки Meshy не виміряє модель.

    • Name
      wall_thickness_mm
      Type
      number
      Description

      Мінімальна товщина стінки для printer_type, у міліметрах.

    • Name
      dimensions_mm
      Type
      array
      Description

      Розміри друку [ширина, глибина, висота], у міліметрах. Висота може відрізнятися від height_mm на частку міліметра. Дорівнює null, доки завдання не завершиться успішно, і завжди null для вхідних даних, відмінних від GLB.

  • Name
    print_repair_report
    Type
    object
    Description

    Що саме зробило відновлення товщини стінки. Присутнє після успішного відновлення товщини стінки.

    • Name
      route
      Type
      string
      Description

      Яке відновлення було виконано, одне з:

      • thin_wall: більш ніж 5% поверхні було занадто тонким, тому також запускалося потовщення стінок. Щоб дізнатися, чи змінило це сітку, перевірте applied.
      • topology: стінки були достатньо товстими, тому запускалося лише відновлення topology.
      • topology_unmeasured: Meshy не зміг виміряти стінки, тому запускалося лише відновлення topology.
    • Name
      applied
      Type
      boolean
      Description

      Чи змінило потовщення стінок сітку. Присутнє лише коли route дорівнює thin_wall.

    • Name
      faces_before
      Type
      integer
      Description

      Кількість граней вхідної сітки. Присутнє лише коли route дорівнює thin_wall.

    • Name
      faces_after
      Type
      integer
      Description

      Кількість граней відновленої сітки. Присутнє лише коли route дорівнює thin_wall.

    • Name
      thin_area_ratio_before
      Type
      number
      Description

      Частка поверхні вхідної моделі, тонша за intended_print.wall_thickness_mm, від 0 до 1. Пропускається, якщо Meshy не зміг виміряти вхідні дані.

    • Name
      thin_area_ratio_after
      Type
      number
      Description

      Та сама частка, виміряна на відновленій моделі. Пропускається, якщо Meshy не зміг її виміряти. Завдання все одно завершується успішно.