Ireretiro ang lowpoly sa Oct 30, 2026. Lumipat ng modelo bago ang mga petsang ito para maiwasan ang mga error sa request. Tingnan ang lahat ng deprecation

Analyze Printability API

Suriin ang isang 3D na modelo para sa mga problema sa pag-print sa pamamagitan ng pagsukat ng watertightness, volume, mga butas, non-manifold edges, at degenerate faces nito. Maaari mo ring suriin ang kapal ng dingding sa sukat na plano mong i-print.


POST/openapi/v1/print/analyze

Gumawa ng Analyze Printability task

Gumagawa ng Analyze Printability task, na nagsusuri sa isang 3D model at nag-uulat ng mga printability metrics nito. Tumatakbo ang task sa background. Para sa kung gaano katagal karaniwang tumatagal ang isang task, tingnan ang Processing times.

Kapag mayroon nang Meshy ng printability result para sa input_task_id na task, agad na handa ang bagong task. Ang iyong unang GET dito ay magbabalik ng resulta.

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

Mga Parameter

  • Name
    input_task_id
    Type
    string
    Kinakailangan
    Description

    Kinakailangan maliban kung ipadala mo ang model_url. Ang ID ng task na ang model nito gusto mong suriin. Dapat may status na SUCCEEDED ang task, at pag-aari mo o nasa isang workspace na kinabibilangan mo.

    Maaari itong isa sa mga sumusunod na uri ng task, gamit ang Meshy 6 o mas bago, kabilang ang Meshy 7:

    Gumagana rin ang isang Repair Printability task.

  • Name
    model_url
    Type
    string
    Kinakailangan
    Description

    Kinakailangan maliban kung ipadala mo ang input_task_id. Ang model na susuriin, bilang isang pampublikong URL o isang data URI. Kung ipapadala mo ang pareho, gagamitin ng Meshy ang input_task_id.

    Mula sa isang http o https URL, dapat ang model ay isang .glb, .gltf, .obj, .fbx, o .stl file na hindi hihigit sa 400 MB. Isang data URI lang ang maaaring maglaman ng base64 GLB (data:model/gltf-binary;base64,...) o glTF (data:model/gltf+json;base64,...) file na hindi hihigit sa 100 MB. Ipadala ang isang .obj, .fbx, o .stl file bilang isang http o https URL.

    Ang isang file na higit sa 100 MB ay dapat ding sumunod sa mga sumusunod na patakaran:

    • Ang isang GLB, glTF, FBX, o OBJ file ay maaaring magkaroon ng hanggang 10,000,000 faces. Binibilang ng Meshy ang mga faces bilang triangles, kaya ang isang quad ay binibilang bilang 2, at ang isang mesh na iginuhit nang higit sa isang beses ay binibilang nang isang beses bawat kopya.
    • Ang isang FBX file ay dapat binary FBX 7.1 o mas bago.
    • Ang isang GLB o glTF file ay hindi dapat gumamit ng Draco compression.

    Ang isang Meshy download URL (assets.meshy.ai/…?Expires=…&Signature=…) ay naka-sign at tumitigil sa paggana sa expires_at ng task nito. Ang muling pagbasa sa task ay hindi ito ibinabago. Para sa isang model na ginawa mo gamit ang Meshy, ipadala na lang ang input_task_id, na gumagana habang pinapanatili ng Meshy ang source task (tingnan ang Asset retention). Upang magamit ang model pagkatapos nito, i-download ito bago ang expires_at at ipadala ang sarili mong kopya.

Upang suriin din ang kapal ng dingding sa laki na balak mong i-print, ipadala ang printer_type, isang print size, o pareho. Ang resulta ay nasa printability.thin_walls. Mas matagal ang pagsuri sa kapal ng dingding, kaya karaniwang hindi agad handa ang task, kahit nasuri na ng Meshy ang model dati.

  • Name
    printer_type
    Type
    string
    Description

    Ang printer na balak mong gamitin. Itinatakda nito ang pinakamababang kapal ng dingding para sa pagsuri ng kapal ng dingding. Kung ipapadala mo ang isang print size nang walang printer_type, gagamitin ng Meshy ang fdm.

    Mga magagamit na value:

    • fdm: filament, 1.0 mm minimum na dingding
    • sla: resin, 0.8 mm minimum na dingding
    • full_color: full-color, 2.0 mm minimum na dingding

    Ang anumang ibang value ay magbabalik ng 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    Ang taas ng print, sa millimeters, mula 1 hanggang 1000. Ang isang value na labas sa range ay magbabalik ng 400. Ipadala ito o ang intended_print_longest_side_mm, hindi pareho.

    Gumagana lang ito sa GLB input. Para sa isang model_url na hindi .glb file, ipadala na lang ang intended_print_longest_side_mm.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    Ang haba ng pinakamahabang gilid ng print, sa millimeters, mula 1 hanggang 1000. Ang isang value na labas sa range ay magbabalik ng 400. Gumagana ito sa bawat format ng input.

Kung ipapadala mo ang printer_type nang walang laki, gagamitin ng Meshy ang print size na ito:

  • .glb file o anumang input_task_id: 150 mm ang taas
  • .stl file: ang sariling pinakamahabang gilid ng file, binabasa bilang millimeters
  • .obj, .fbx, o .gltf file: 150 mm sa pinakamahabang gilid

Para sa isang STL file sa ibang mga unit, ipadala ang intended_print_longest_side_mm.

Binubuo ng Meshy ang parehong print sizes sa pinakamalapit na millimeter.

Mga Ibabalik

Ang field na result ng tugon ay naglalaman ng ID ng bagong Analyze Printability task.

Mga paraan ng pagkabigo

  • Name
    400 - Bad Request
    Description

    Hindi maaaring tumakbo ang request. Sinasabi ng error message kung aling problema ang nahanap nito. Halimbawa:

    • Nawawalang parameter: Hindi ipinadala ang alinman sa input_task_id o model_url.
    • Di-wastong UUID: Hindi wastong UUID ang input_task_id.
    • Di-wastong model URL: Malformed ang model_url, gumagamit ng hindi suportadong scheme, o may hindi suportadong file extension.
    • Masyadong malaki ang model file: Ang model_url file ay higit sa 400 MB mula sa isang http o https URL, o higit sa 100 MB bilang isang data URI.
    • Sobrang dami ng faces: Ang model_url file ay isang GLB, glTF, FBX, o OBJ file na higit sa 100 MB na may higit sa 10,000,000 faces. Bawasan ang bilang ng faces, pagkatapos ipadala muli ang file.
    • ASCII FBX na higit sa 100 MB: Ang model_url file ay isang ASCII FBX na higit sa 100 MB. Ipadala ito bilang binary FBX o GLB.
    • Hindi mabasang model file: Ang model_url file ay higit sa 100 MB, at hindi mabasa ng Meshy ang header nito. Halimbawa, ito ay isang Draco-compressed GLB o glTF, o isang binary FBX na mas luma sa 7.1.
    • Masyadong komplikado ang model header: Ang model_url file ay higit sa 100 MB, at ang header nito ay may napakaraming mesh, node, o record para suriin. Bawasan ang bilang ng mga object sa file, pagkatapos ipadala ito muli.
    • Hindi ma-download ang model file: Nagbalik ng error ang model_url, kadalasan dahil nag-expire ang isang naka-sign na Meshy download URL. Ang muling pagbasa sa task ay magbabalik ng parehong URL na may parehong pag-expire. Ipadala ang sarili mong kopya ng file, o ipadala ang input_task_id habang pinapanatili ng Meshy ang source task.
    • Hindi nagtagumpay ang task: Ang input_task_id na task ay nasa pending pa rin, in progress, o nabigo.
    • Di-wastong print size: Ang intended_print_height_mm o intended_print_longest_side_mm ay wala sa 1 hanggang 1000, o mayroon ang request na pareho.
    • Hindi kilalang uri ng printer: Ang printer_type ay hindi fdm, sla, o full_color.
    • Taas sa isang non-GLB na model: Mayroon ang request ng intended_print_height_mm at isang model_url na hindi .glb file. Ipadala na lang ang intended_print_longest_side_mm.
    • Hindi masukat ang model na ito ayon sa taas: Sa hiniling na taas, o sa default na 150 mm, ang pinakamahabang gilid ng model ay magiging labas sa 1 hanggang 1,000 mm. Nangyayari rin ito kapag flat ang model, o kapag hindi matukoy ng Meshy ang laki nito. Ipadala na lang ang intended_print_longest_side_mm. Para sa isang .glb model_url at ilang input_task_id na task, nalalaman ito ng Meshy pagkatapos lang magsimula ang task, at ang task ay magtatapos bilang FAILED sa halip.
    • Hindi magamit ang STL size: Mayroon ang request ng printer_type nang walang laki, at hindi mabasa ng Meshy ang sariling pinakamahabang gilid ng .stl file, o wala ito sa 1 hanggang 1,000 mm. Ipadala ang intended_print_longest_side_mm.

    Ayusin ang request, pagkatapos ipadala ito muli. Tingnan ang Errors.

  • Name
    401 - Unauthorized
    Description

    Nawawala o hindi wasto ang API key. Suriin ang Authorization header.

  • Name
    403 - Forbidden
    Description

    Ang input_task_id ay isang bas-relief na model, na hindi masusuri ng endpoint na ito. Ang mensahe ay This model type does not support this operation. Magpadala ng ibang model.

  • Name
    404 - Not Found
    Description

    Hindi makahanap ang Meshy ng model na susuriin para sa input_task_id. Halimbawa:

    • Hindi umiiral ang task, nabura, o hindi pag-aari mo o nasa isang workspace na kinabibilangan mo.
    • Gumagamit ang task ng model na mas luma sa Meshy 6, o hindi gumagawa ang uri nito ng 3D model.
    • Wala na sa storage ang model file ng task.

    Suriin na ang input_task_id ay isang suportadong task na pag-aari mo o nasa isa sa iyong mga workspace, o ipadala ang model bilang model_url.

  • Name
    429 - Too Many Requests
    Description

    Nalagpasan mo ang iyong rate limit, o mayroon kang masyadong maraming nakabinbing task. Maghintay, pagkatapos subukan muli. Tingnan ang Rate limits.


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

Kunin ang Analyze Printability na gawain

Ibinabalik ang isang Analyze Printability na gawain gamit ang ID nito.

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
}

Mga Parameter

  • Name
    id
    Type
    path
    Description

    Ang task ID mula sa create response.

Ibinabalik

Ang Analyze Printability task object. Hindi lilitaw ang printability field nito hanggang SUCCEEDED na ang gawain. Kapag sinuri ni Meshy ang kapal ng dingding, kasama rin sa printability ang intended_print at thin_walls.


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

I-delete ang isang Analyze Printability na task

Permanenteng binubura ang isang Analyze Printability na task, kasama ang naka-cache nitong resulta. Hindi mo na maibabalik ang pagbura.

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

Mga path parameter

  • Name
    id
    Type
    path
    Description

    Ang ID ng task na ibubura.

Status ng task

Kapag binura mo ang isang PENDING na task, mare-refund ang mga credits na ginamit nito noong ginawa mo ito.

Hindi mabubura ang isang IN_PROGRESS na task. Ibabalik ng request ang 409 Conflict, at magpapatuloy pa ring tumakbo ang task. Hindi nire-refund ng Meshy ang isang task na nagsimula na, kaya kung ibubura mo ito, mawawala sa iyo pareho ang credits at ang resulta. Hintayin munang maabot nito ang SUCCEEDED, FAILED, o CANCELED, saka ito burahin.

Ang pagbura sa isang task na nasa final na status (SUCCEEDED, FAILED, o CANCELED) ay hindi nagre-refund ng mga credits nito.

Ibinabalik

200 OK kapag nabura na ang task, o 409 Conflict kapag ang task ay IN_PROGRESS.


GET/openapi/v1/print/analyze

I-list ang mga Analyze Printability na gawain

Nagbabalik ng listahan ng iyong mga Analyze Printability na gawain.

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

Mga Parameter

  • Name
    page_num
    Type
    integer
    default 1
    Description

    Ang numero ng pahinang ibabalik, nagsisimula sa 1.

  • Name
    page_size
    Type
    integer
    default 10
    Description

    Ang bilang ng mga gawain kada pahina, hanggang 100.

  • Name
    sort_by
    Type
    string
    Description

    Ang pagkakaayos ng pagsunud-sunod.

    Mga magagamit na halaga:

    • +created_at: pinakaluma muna
    • -created_at: pinakabago muna

Ibinabalik

Isang paginated na listahan ng Analyze Printability task objects.


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

I-stream ang isang Analyze Printability na gawain

Nagsa-stream ng mga update ng isang Analyze Printability na gawain bilang 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
}

Mga Parameter

  • Name
    id
    Type
    path
    Description

    Ang task ID mula sa tugon ng paggawa (create response).

Ibinabalik

Isang stream ng Analyze Printability task objects bilang Server-Sent Events.

Bawat event ay naglalaman ng buong task object, sa parehong anyo na ibinabalik ng Get endpoint. Habang ang gawain ay PENDING o IN_PROGRESS, walang laman ang mga output field nito (null, [], o {}), at ang finished_at ay 0. Ipinapadala lamang ni Meshy ang field na printability kapag ang gawain ay SUCCEEDED na.


Ang Analyze Printability task object

Ang isang Analyze Printability task object ay naglalarawan ng isang pagsusuri ng isang 3D model. Naglalaman ito ng status, ang progress, at ang resulta ng printability kapag nagtagumpay ang task.

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

    Ang task ID. Ituring ito bilang isang opaque string, at huwag umasa sa format nito.

  • Name
    type
    Type
    string
    Description

    Ang uri ng task, palaging print-analyze.

  • Name
    status
    Type
    string
    Description

    Ang status ng task, isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, o CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Kung gaano karami ang natapos sa task, bilang isang porsyento. Ito ay 0 hanggang magsimula ang task at 100 kapag ito ay nagtagumpay.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Ang bilang ng mga task na nauuna rito sa pila. Makabuluhan lamang ang value habang ang task ay PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

    Oras na nilikha ang task, sa Unix milliseconds.

  • Name
    started_at
    Type
    timestamp
    Description

    Oras na nagsimula ang task, sa Unix milliseconds. Ito ay 0 hanggang magsimula ang task.

  • Name
    finished_at
    Type
    timestamp
    Description

    Oras na natapos ang task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.

  • Name
    expires_at
    Type
    timestamp
    Description

    Oras na mag-e-expire ang resulta ng task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.

  • Name
    task_error
    Type
    object
    Description

    Ang mga detalye ng error kapag nabigo ang task. Ito ay null kung hindi nabigo ang task. Tingnan ang Errors.

    • Name
      message
      Type
      string
      Description

      Isang paglalarawan kung ano ang nangyaring mali.

  • Name
    printability
    Type
    object
    Description

    Ang resulta ng pagsusuri. Hindi ito naroroon hangga't hindi SUCCEEDED ang task.

    • Name
      _version
      Type
      string
      Description

      Ang schema version ng resulta ng printability. Ang value ay v1.

    • Name
      status
      Type
      string
      Description

      Ang pangkalahatang pasya, isa sa mga sumusunod:

      • healthy: walang errors at walang warnings
      • warning: may kahit isang warning, at walang errors
      • error: may kahit isang error
      • unknown: hindi masuri ni Meshy ang model

      Kapag sinuri ni Meshy ang kapal ng dingding, ito ang mas masama sa pagitan ng mesh checks at thin_walls.status. Mula sa pinakamasama hanggang sa pinakamahusay, ang pagkakasunod-sunod ay error, warning, unknown, at healthy.

    • Name
      issue_count
      Type
      integer
      Description

      Ang kabuuang bilang ng mga isyu, katumbas ng error_count + warning_count.

    • Name
      error_count
      Type
      integer
      Description

      Ang bilang ng mga isyu sa antas ng error. Nagbibilang si Meshy ng isang error para sa bawat isa sa mga sumusunod:

      • Hindi watertight ang model at may higit sa 8 butas.
      • May higit sa 8 butas ang model.
      • Ang volume ay zero o mas mababa.
      • May higit sa 50 non-manifold edges ang model.

      Kapag sinuri ni Meshy ang kapal ng dingding, ang mga dingdingna masyadong manipis (thin_walls.status ay error) ay binibilang bilang isa pang error.

    • Name
      warning_count
      Type
      integer
      Description

      Ang bilang ng mga isyu sa antas ng warning. Nagbibilang si Meshy ng isang warning para sa bawat isa sa mga sumusunod:

      • Hindi watertight ang model at may 8 butas o mas kaunti.
      • May 1 hanggang 8 butas ang model.
      • May 1 hanggang 50 non-manifold edges ang model.
      • May degenerate faces ang model.
    • Name
      metrics
      Type
      object
      Description

      Ang hilaw na mga sukat ng heometriya ng model.

      • Name
        is_watertight
        Type
        boolean
        Description

        true kapag walang boundary edges ang mesh, ibig sabihin, kapag ito ay sarado.

      • Name
        volume
        Type
        number
        Description

        Ang volume ng model, sa cubic meters.

      • Name
        non_manifold_edges
        Type
        integer
        Description

        Ang bilang ng non-manifold edges.

      • Name
        degenerate_faces
        Type
        integer
        Description

        Ang bilang ng degenerate faces, na mga faces na may zero area o invalid na mga faces.

      • Name
        holes
        Type
        integer
        Description

        Ang bilang ng mga butas sa mesh, binibilang bilang boundary loops.

    • Name
      intended_print
      Type
      object
      Description

      Ang printer at sukat na ginamit ng pagsusuri ng kapal ng dingding. Naroroon lamang kapag sinuri ni Meshy ang kapal ng dingding.

      • Name
        printer_type
        Type
        string
        Description

        Ang uri ng printer, fdm, sla, o full_color.

      • Name
        height_mm
        Type
        number
        Description

        Ang taas ng print, sa millimeters, kapag ang print ay sinusukat base sa taas. Kung hindi, ito ay null.

      • Name
        longest_side_mm
        Type
        number
        Description

        Ang haba ng pinakamahabang gilid ng print, sa millimeters. Kapag ang print ay sinusukat base sa taas, kinakalkula ito ni Meshy mula sa mga proporsyon ng model.

      • Name
        wall_thickness_mm
        Type
        number
        Description

        Ang pinakamababang kapal ng dingding para sa printer_type, sa millimeters. Iniuulat ni Meshy ang mas manipis na mga dingding bilang masyadong manipis.

      • Name
        dimensions_mm
        Type
        array
        Description

        Ang [width, depth, height] ng print, sa millimeters. Maaaring magkaiba ang taas sa height_mm nang ilang bahagi ng isang millimeter. Ito ay null para sa input na hindi GLB, o kapag hindi matukoy ni Meshy ang sukat ng model.

    • Name
      thin_walls
      Type
      object
      Description

      Ang resulta ng pagsusuri ng kapal ng dingding. Naroroon lamang kapag sinuri ni Meshy ang kapal ng dingding.

      • Name
        thin_area_ratio
        Type
        number
        Description

        Ang bahagi ng ibabaw na mas manipis kaysa sa intended_print.wall_thickness_mm, mula 0 hanggang 1. Ito ay null kapag hindi masukat ni Meshy ang model.

      • Name
        has_thin_walls
        Type
        boolean
        Description

        true kung anumang bahagi ng ibabaw ay masyadong manipis. Ang matatalim na sulok lamang ay maaaring gawin itong true, kaya gamitin ang status upang magpasya kung kailangang palapitin ang mga dingding. Ito ay null kapag hindi masukat ni Meshy ang model.

      • Name
        status
        Type
        string
        Description

        Ang pasya sa kapal ng dingding, isa sa mga sumusunod:

        • healthy: 5% o mas kaunti sa ibabaw ang masyadong manipis.
        • error: higit sa 5% ng ibabaw ang masyadong manipis. Upang palapitin ang mga dingding, ipadala ang id ng task na ito sa Repair Printability bilang input_task_id. Kung sinuri ng task na ito ang isang .stl, .fbx, o .gltf file mula sa model_url, ipadala na lamang ang file na iyon bilang model_url.
        • unknown: hindi masukat ni Meshy ang model. Kung mabigo mismo ang pagsusuri ng kapal ng dingding, matatapos ang task bilang FAILED.
    • Name
      evaluated_at
      Type
      timestamp
      Description

      Oras na kinakalkula ni Meshy ang pagsusuri, sa Unix milliseconds.

  • Name
    consumed_credits
    Type
    integer
    Description

    Ang bilang ng credits na ginamit ng task. Ito ay palaging 0, dahil libre ang pagsusuri.