lowpoly будет отключён 30 окт. 2026 г.. Перейдите на другую модель до этих дат, чтобы избежать ошибок в запросах. Все устаревшие функции

Analyze Printability API

Проверьте 3D-модель на наличие проблем с печатью, измерив её водонепроницаемость, объём, отверстия, немногообразные рёбра и вырожденные грани. Вы также можете проверить толщину стенки при том размере, в котором планируете выполнять печать.


POST/openapi/v1/print/analyze

Создать задачу Анализ пригодности к печати

Создаёт задачу Анализ пригодности к печати, которая оценивает 3D-модель и сообщает её показатели пригодности к печати. Задача выполняется в фоновом режиме. О том, сколько обычно занимает выполнение задачи, см. Время обработки.

Если у Meshy уже есть результат анализа пригодности к печати для задачи input_task_id, новая задача готова сразу же. Ваш первый запрос GET по ней вернёт результат.

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

Параметры

  • 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 может содержать только base64 файл GLB (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 и отправьте собственную копию.

Чтобы также проверить толщину стенки при размере, в котором вы планируете печатать, отправьте printer_type, размер печати или оба параметра. Результат содержится в printability.thin_walls. Проверка толщины стенки занимает больше времени, поэтому задача обычно не готова сразу же, даже если Meshy уже анализировал эту модель ранее.

  • Name
    printer_type
    Type
    string
    Description

    Принтер, который вы планируете использовать. Он задаёт минимальную толщину стенки для проверки толщины стенки. Если вы отправите размер печати без printer_type, Meshy использует fdm.

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

    • 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 использует следующий размер печати:

  • файл .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 всё ещё ожидает выполнения, выполняется или завершилась неудачей.
    • Недопустимый размер печати: 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
    403 - Forbidden
    Description

    input_task_id — это модель с барельефом, которую этот эндпоинт не может проанализировать. Сообщение: This model type does not support this operation. Отправьте другую модель.

  • Name
    404 - Not Found
    Description

    Meshy не может найти модель для анализа по input_task_id. Например:

    • Задача не существует, была удалена или не принадлежит вам либо рабочей области, к которой вы принадлежите.
    • Задача использует модель старше Meshy 6, либо её тип не создаёт 3D-модель.
    • Файл модели задачи больше не хранится.

    Убедитесь, что input_task_id — это поддерживаемая задача, принадлежащая вам или одной из ваших рабочих областей, либо отправьте модель как model_url.

  • Name
    429 - Too Many Requests
    Description

    Вы превысили ограничение частоты запросов, либо у вас слишком много ожидающих задач. Подождите, затем повторите попытку. См. Ограничения частоты.


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

Получить задачу Анализа пригодности к печати

Возвращает задачу Анализа пригодности к печати по её 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
}

Параметры

  • Name
    id
    Type
    path
    Description

    ID задачи из ответа при создании.

Возвращает

Объект задачи Анализа пригодности к печати. Поле printability отсутствует, пока задача не получит статус SUCCEEDED. Если Meshy проверял толщину стенки, printability также включает intended_print и thin_walls.


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

Удаление задачи Анализа пригодности к печати

Безвозвратно удаляет задачу Анализа пригодности к печати, включая её кешированный результат. Отменить удаление нельзя.

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

Параметры пути

  • 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/analyze

Список задач Анализа пригодности к печати

Возвращает список ваших задач Анализа пригодности к печати.

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

Параметры

  • 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/analyze/:id/stream

Поток обновлений задачи Анализа пригодности к печати

Передаёт обновления задачи Анализа пригодности к печати в виде Server-Sent Events (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
}

Параметры

  • Name
    id
    Type
    path
    Description

    ID задачи из ответа на создание.

Возвращает

Поток объектов задачи Анализа пригодности к печати в виде Server-Sent Events.

Каждое событие содержит полный объект задачи — в том же виде, который возвращает эндпоинт Get. Пока задача находится в статусе PENDING или IN_PROGRESS, её выходные поля пусты (null, [] или {}), а finished_at равно 0. Meshy отправляет поле printability только после того, как задача переходит в статус SUCCEEDED.


Объект задачи Анализ пригодности к печати

Объект задачи Анализ пригодности к печати описывает один анализ 3D-модели. Он содержит статус, прогресс и результат анализа пригодности к печати при успешном завершении задачи.

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

    ID задачи. Рассматривайте его как непрозрачную строку и не полагайтесь на её формат.

  • Name
    type
    Type
    string
    Description

    Тип задачи, всегда print-analyze.

  • 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
    printability
    Type
    object
    Description

    Результат анализа. Отсутствует, пока задача не перейдёт в статус SUCCEEDED.

    • Name
      _version
      Type
      string
      Description

      Версия схемы результата анализа пригодности к печати. Значение — v1.

    • Name
      status
      Type
      string
      Description

      Общий вердикт, один из:

      • healthy: нет ни ошибок, ни предупреждений
      • warning: есть хотя бы одно предупреждение и нет ошибок
      • error: есть хотя бы одна ошибка
      • unknown: Meshy не смог проанализировать модель

      Когда Meshy проверял толщину стенки, это худшее из значений проверок сетки и thin_walls.status. От худшего к лучшему порядок таков: error, warning, unknown и healthy.

    • Name
      issue_count
      Type
      integer
      Description

      Общее количество проблем, равное error_count + warning_count.

    • Name
      error_count
      Type
      integer
      Description

      Количество проблем уровня ошибки. Meshy засчитывает одну ошибку за каждое из следующего:

      • Модель не является водонепроницаемой и имеет более 8 отверстий.
      • В модели более 8 отверстий.
      • Объём равен нулю или меньше нуля.
      • В модели более 50 немногообразных рёбер.

      Когда Meshy проверял толщину стенки, стенки, которые слишком тонкие (thin_walls.status равно error), засчитываются как ещё одна ошибка.

    • Name
      warning_count
      Type
      integer
      Description

      Количество проблем уровня предупреждения. Meshy засчитывает одно предупреждение за каждое из следующего:

      • Модель не является водонепроницаемой и имеет 8 или менее отверстий.
      • В модели от 1 до 8 отверстий.
      • В модели от 1 до 50 немногообразных рёбер.
      • В модели есть вырожденные грани.
    • Name
      metrics
      Type
      object
      Description

      Необработанные геометрические измерения модели.

      • Name
        is_watertight
        Type
        boolean
        Description

        true, когда у сетки нет граничных рёбер, то есть когда она замкнута.

      • Name
        volume
        Type
        number
        Description

        Объём модели, в кубических метрах.

      • Name
        non_manifold_edges
        Type
        integer
        Description

        Количество немногообразных рёбер.

      • Name
        degenerate_faces
        Type
        integer
        Description

        Количество вырожденных граней, то есть граней с нулевой площадью или недопустимых граней.

      • Name
        holes
        Type
        integer
        Description

        Количество отверстий в сетке, подсчитанное как количество граничных контуров.

    • Name
      intended_print
      Type
      object
      Description

      Принтер и размер, использованные при проверке толщины стенки. Присутствует только когда Meshy проверял толщину стенки.

      • 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 вычисляет это значение из пропорций модели.

      • Name
        wall_thickness_mm
        Type
        number
        Description

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

      • Name
        dimensions_mm
        Type
        array
        Description

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

    • Name
      thin_walls
      Type
      object
      Description

      Результат проверки толщины стенки. Присутствует только когда Meshy проверял толщину стенки.

      • Name
        thin_area_ratio
        Type
        number
        Description

        Доля поверхности, более тонкая, чем intended_print.wall_thickness_mm, от 0 до 1. Равно null, когда Meshy не смог измерить модель.

      • Name
        has_thin_walls
        Type
        boolean
        Description

        true, если какая-либо часть поверхности слишком тонкая. Одни лишь острые углы могут сделать это значение true, поэтому используйте status, чтобы решить, нужно ли утолщать стенки. Равно null, когда Meshy не смог измерить модель.

      • Name
        status
        Type
        string
        Description

        Вердикт по толщине стенки, один из:

        • healthy: 5% или менее поверхности слишком тонкие.
        • error: более 5% поверхности слишком тонкие. Чтобы утолщить стенки, отправьте id этой задачи в Восстановление пригодности к печати как input_task_id. Если эта задача анализировала файл .stl, .fbx или .gltf из model_url, вместо этого отправьте этот файл как model_url.
        • unknown: Meshy не смог измерить модель. Если сама проверка толщины стенки не удаётся, задача завершается со статусом FAILED.
    • Name
      evaluated_at
      Type
      timestamp
      Description

      Время, когда Meshy вычислил анализ, в миллисекундах Unix.

  • Name
    consumed_credits
    Type
    integer
    Description

    Количество кредитов, использованных задачей. Всегда равно 0, так как анализ бесплатен.