lowpoly akan dihentikan pada 30 Okt 2026. Tukar model sebelum tarikh-tarikh ini untuk mengelakkan ralat permintaan. Lihat semua penamatan

API Analisis Kebolehcetakan

Semak model 3D untuk masalah percetakan dengan mengukur ketahanan kedap airnya, isipadu, lubang, tepi non-manifold, dan muka degenerat. Anda juga boleh menyemak ketebalan dinding pada saiz yang anda rancang untuk mencetak.


POST/openapi/v1/print/analyze

Create an Analyze Printability task

Mencipta tugas Analisis kebolehcetakan, yang menilai model 3D dan melaporkan metrik kebolehcetakannya. Tugas ini berjalan di latar belakang. Untuk tempoh masa yang biasanya diambil oleh sesuatu tugas, lihat Processing times.

Apabila Meshy sudah mempunyai hasil kebolehcetakan untuk tugas input_task_id, tugas baharu tersebut sedia dengan serta-merta. GET pertama anda ke atasnya akan memulangkan hasil tersebut.

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

Parameter

  • Name
    input_task_id
    Type
    string
    Diperlukan
    Description

    Diperlukan kecuali anda menghantar model_url. ID tugas yang modelnya ingin anda analisis. Tugas tersebut mestilah berstatus SUCCEEDED, dan milik anda sendiri atau berada dalam ruang kerja yang anda sertai.

    Ia boleh menjadi salah satu daripada jenis tugas ini, menggunakan Meshy 6 atau lebih baharu, termasuk Meshy 7:

    Tugas Baiki kebolehcetakan juga berfungsi.

  • Name
    model_url
    Type
    string
    Diperlukan
    Description

    Diperlukan kecuali anda menghantar input_task_id. Model untuk dianalisis, sebagai URL awam atau Data URI. Jika anda menghantar kedua-duanya, Meshy menggunakan input_task_id.

    Daripada URL http atau https, model mestilah fail .glb, .gltf, .obj, .fbx, atau .stl yang bersaiz tidak lebih daripada 400 MB. Data URI hanya boleh menyimpan fail GLB base64 (data:model/gltf-binary;base64,...) atau glTF (data:model/gltf+json;base64,...) yang bersaiz tidak lebih daripada 100 MB. Hantar fail .obj, .fbx, atau .stl sebagai URL http atau https.

    Fail yang melebihi 100 MB juga mesti mematuhi peraturan berikut:

    • Fail GLB, glTF, FBX, atau OBJ boleh mempunyai sebanyak-banyaknya 10,000,000 muka. Meshy mengira muka sebagai segi tiga, jadi segi empat tepat dikira sebagai 2, dan jejaring yang dilukis lebih daripada sekali dikira sekali bagi setiap salinan.
    • Fail FBX mestilah FBX binari 7.1 atau lebih baharu.
    • Fail GLB atau glTF tidak boleh menggunakan pemampatan Draco.

    URL muat turun Meshy (assets.meshy.ai/…?Expires=…&Signature=…) ditandatangani dan berhenti berfungsi pada expires_at tugas tersebut. Membaca tugas itu semula tidak memperbaharuinya. Untuk model yang anda buat dengan Meshy, hantar input_task_id sebaliknya, yang berfungsi selagi Meshy mengekalkan tugas sumber (lihat Asset retention). Untuk menggunakan model tersebut selepas itu, muat turun sebelum expires_at dan hantar salinan anda sendiri.

Untuk turut memeriksa ketebalan dinding pada saiz yang anda rancang untuk mencetak, hantar printer_type, saiz cetakan, atau kedua-duanya. Hasilnya berada dalam printability.thin_walls. Memeriksa ketebalan dinding mengambil masa lebih lama, jadi tugas tersebut biasanya tidak sedia dengan serta-merta, walaupun Meshy telah menganalisis model tersebut sebelum ini.

  • Name
    printer_type
    Type
    string
    Description

    Pencetak yang anda rancang untuk digunakan. Ia menetapkan ketebalan dinding minimum untuk pemeriksaan ketebalan dinding. Jika anda menghantar saiz cetakan tanpa printer_type, Meshy menggunakan fdm.

    Nilai yang tersedia:

    • fdm: filamen, dinding minimum 1.0 mm
    • sla: resin, dinding minimum 0.8 mm
    • full_color: warna penuh, dinding minimum 2.0 mm

    Sebarang nilai lain memulangkan 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    Ketinggian cetakan, dalam milimeter, dari 1 hingga 1000. Nilai di luar julat ini memulangkan 400. Hantar ini atau intended_print_longest_side_mm, bukan kedua-duanya.

    Ia hanya berfungsi dengan input GLB. Untuk model_url yang bukan fail .glb, hantar intended_print_longest_side_mm sebaliknya.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    Panjang bahagian terpanjang cetakan, dalam milimeter, dari 1 hingga 1000. Nilai di luar julat ini memulangkan 400. Ia berfungsi dengan setiap format input.

Jika anda menghantar printer_type tanpa saiz, Meshy menggunakan saiz cetakan ini:

  • fail .glb atau mana-mana input_task_id: tinggi 150 mm
  • fail .stl: bahagian terpanjang fail itu sendiri, dibaca sebagai milimeter
  • fail .obj, .fbx, atau .gltf: 150 mm pada bahagian terpanjang

Untuk fail STL dalam unit lain, hantar intended_print_longest_side_mm.

Meshy membundarkan kedua-dua saiz cetakan kepada milimeter terdekat.

Pulangan

Medan result bagi respons tersebut memegang ID tugas Analisis kebolehcetakan yang baharu.

Mod kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Mesej ralat menyatakan masalah yang ditemuinya. Sebagai contoh:

    • Parameter hilang: Sama ada input_task_id mahupun model_url tidak dihantar.
    • UUID tidak sah: input_task_id bukan UUID yang sah.
    • URL model tidak sah: model_url cacat bentuk, menggunakan skema yang tidak disokong, atau mempunyai sambungan fail yang tidak disokong.
    • Fail model terlalu besar: Fail model_url melebihi 400 MB daripada URL http atau https, atau melebihi 100 MB sebagai Data URI.
    • Terlalu banyak muka: Fail model_url ialah fail GLB, glTF, FBX, atau OBJ yang melebihi 100 MB dengan lebih daripada 10,000,000 muka. Kurangkan bilangan muka, kemudian hantar fail itu semula.
    • ASCII FBX melebihi 100 MB: Fail model_url ialah ASCII FBX yang melebihi 100 MB. Hantarnya sebagai FBX binari atau GLB.
    • Fail model tidak boleh dibaca: Fail model_url melebihi 100 MB, dan Meshy tidak dapat membaca headernya. Sebagai contoh, ia merupakan GLB atau glTF yang dimampatkan dengan Draco, atau FBX binari yang lebih lama daripada 7.1.
    • Header model terlalu kompleks: Fail model_url melebihi 100 MB, dan headernya mempunyai terlalu banyak jejaring, nod, atau rekod untuk diperiksa. Kurangkan bilangan objek dalam fail itu, kemudian hantar semula.
    • Fail model tidak dapat dimuat turun: model_url memulangkan ralat, selalunya kerana URL muat turun Meshy yang ditandatangani telah luput. Membaca tugas itu semula memulangkan URL yang sama dengan tamat tempoh yang sama. Hantar salinan fail anda sendiri, atau hantar input_task_id selagi Meshy mengekalkan tugas sumber.
    • Tugas tidak berjaya: Tugas input_task_id masih dalam keadaan belum selesai, sedang dijalankan, atau gagal.
    • Saiz cetakan tidak sah: intended_print_height_mm atau intended_print_longest_side_mm berada di luar julat 1 hingga 1000, atau permintaan tersebut mengandungi kedua-duanya.
    • Jenis pencetak tidak diketahui: printer_type bukan fdm, sla, atau full_color.
    • Ketinggian pada model bukan GLB: Permintaan mengandungi intended_print_height_mm dan model_url yang bukan fail .glb. Hantar intended_print_longest_side_mm sebaliknya.
    • Tidak dapat menentukan saiz model ini melalui ketinggian: Pada ketinggian yang diminta, atau lalai 150 mm, bahagian terpanjang model akan berada di luar julat 1 hingga 1,000 mm. Ini juga berlaku apabila model tersebut rata, atau apabila Meshy tidak dapat menentukan saiznya. Hantar intended_print_longest_side_mm sebaliknya. Untuk model_url .glb dan sesetengah tugas input_task_id, Meshy hanya mendapati ini selepas tugas bermula, dan tugas tersebut berakhir sebagai FAILED sebaliknya.
    • Saiz STL tidak boleh digunakan: Permintaan mengandungi printer_type tanpa saiz, dan Meshy tidak dapat membaca bahagian terpanjang fail .stl itu sendiri, atau ia berada di luar julat 1 hingga 1,000 mm. Hantar intended_print_longest_side_mm.

    Betulkan permintaan tersebut, kemudian hantar semula. Lihat Errors.

  • Name
    401 - Unauthorized
    Description

    Kunci API hilang atau tidak sah. Semak header Authorization.

  • Name
    403 - Forbidden
    Description

    input_task_id ialah model bas-relief, yang tidak dapat dianalisis oleh endpoint ini. Mesejnya ialah This model type does not support this operation. Hantar model yang lain.

  • Name
    404 - Not Found
    Description

    Meshy tidak dapat mencari model untuk dianalisis bagi input_task_id. Sebagai contoh:

    • Tugas tersebut tidak wujud, telah dipadam, atau bukan milik anda mahupun berada dalam ruang kerja yang anda sertai.
    • Tugas tersebut menggunakan model yang lebih lama daripada Meshy 6, atau jenisnya tidak menghasilkan model 3D.
    • Fail model tugas tersebut tidak lagi berada dalam storan.

    Pastikan input_task_id ialah tugas yang disokong, milik anda sendiri atau berada dalam salah satu ruang kerja anda, atau hantar model tersebut sebagai model_url.

  • Name
    429 - Too Many Requests
    Description

    Anda telah melebihi had kadar anda, atau anda mempunyai terlalu banyak tugas yang belum selesai. Tunggu, kemudian cuba semula. Lihat Rate limits.


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

Dapatkan tugas Analisis kebolehcetakan

Mengembalikan tugas Analisis kebolehcetakan mengikut ID-nya.

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
}

Parameter

  • Name
    id
    Type
    path
    Description

    ID tugas daripada respons create.

Pulangan

Objek tugas Analisis kebolehcetakan. Medan printability-nya tidak akan wujud sehingga tugas itu SUCCEEDED. Apabila Meshy memeriksa ketebalan dinding, printability juga turut menyertakan intended_print dan thin_walls.


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

Padam tugas Analisis kebolehcetakan

Memadamkan tugas Analisis kebolehcetakan secara kekal, termasuk hasil cache-nya. Anda tidak boleh membatalkan tindakan padam.

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

Parameter laluan

  • Name
    id
    Type
    path
    Description

    ID tugas yang hendak dipadamkan.

Status tugas

Memadamkan tugas PENDING akan memulangkan semula kredit yang digunakan semasa anda mencipta tugas tersebut.

Tugas IN_PROGRESS tidak boleh dipadamkan. Permintaan akan mengembalikan 409 Conflict, dan tugas tersebut akan terus berjalan. Meshy tidak memulangkan kredit untuk tugas yang telah dimulakan, jadi memadamkannya akan merugikan anda dari segi kredit dan hasil. Tunggu sehingga ia mencapai status SUCCEEDED, FAILED, atau CANCELED, kemudian padamkannya.

Memadamkan tugas yang berada dalam status akhir (SUCCEEDED, FAILED, atau CANCELED) tidak akan memulangkan semula kreditnya.

Mengembalikan

200 OK apabila tugas berjaya dipadamkan, atau 409 Conflict apabila tugas berstatus IN_PROGRESS.


GET/openapi/v1/print/analyze

Senaraikan tugas Analisis kebolehcetakan

Mengembalikan senarai tugas Analisis kebolehcetakan anda.

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

Parameter

  • Name
    page_num
    Type
    integer
    lalai 1
    Description

    Nombor halaman yang dikembalikan, bermula pada 1.

  • Name
    page_size
    Type
    integer
    lalai 10
    Description

    Bilangan tugas setiap halaman, sehingga 100.

  • Name
    sort_by
    Type
    string
    Description

    Susunan isihan.

    Nilai yang tersedia:

    • +created_at: paling lama dahulu
    • -created_at: paling baru dahulu

Mengembalikan

Senarai berhalaman bagi objek tugas Analisis kebolehcetakan.


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

Alirkan tugas Analisis kebolehcetakan

Mengalirkan kemas kini tugas Analisis kebolehcetakan sebagai 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
}

Parameter

  • Name
    id
    Type
    path
    Description

    ID tugas daripada respons create.

Pulangan

Aliran objek tugas Analisis kebolehcetakan sebagai Server-Sent Events.

Setiap event memegang objek tugas yang lengkap, dalam bentuk yang sama seperti yang dikembalikan oleh endpoint Get. Semasa tugas berstatus PENDING atau IN_PROGRESS, medan outputnya kosong (null, [], atau {}), dan finished_at bernilai 0. Meshy hanya menghantar medan printability selepas tugas itu SUCCEEDED.


Objek tugas Analisis Kebolehcetakan

Objek tugas Analisis Kebolehcetakan menerangkan satu analisis model 3D. Ia menyimpan status, progress, dan hasil kebolehcetakan apabila tugas berjaya.

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 tugas. Anggap ia sebagai rentetan legap, dan jangan bergantung pada formatnya.

  • Name
    type
    Type
    string
    Description

    Jenis tugas, sentiasa print-analyze.

  • Name
    status
    Type
    string
    Description

    Status tugas, salah satu daripada PENDING, IN_PROGRESS, SUCCEEDED, FAILED, atau CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Berapa banyak tugas telah selesai, sebagai peratusan. Ia adalah 0 sehingga tugas bermula dan 100 apabila ia berjaya.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Bilangan tugas yang mendahului tugas ini dalam baris gilir. Nilai ini bermakna hanya semasa tugas berstatus PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

    Masa tugas dicipta, dalam milisaat Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Masa tugas bermula, dalam milisaat Unix. Ia adalah 0 sehingga tugas bermula.

  • Name
    finished_at
    Type
    timestamp
    Description

    Masa tugas selesai, dalam milisaat Unix. Ia adalah 0 sehingga tugas selesai.

  • Name
    expires_at
    Type
    timestamp
    Description

    Masa hasil tugas tamat tempoh, dalam milisaat Unix. Ia adalah 0 sehingga tugas selesai.

  • Name
    task_error
    Type
    object
    Description

    Butiran ralat apabila tugas gagal. Ia adalah null jika tugas tidak gagal. Lihat Ralat.

    • Name
      message
      Type
      string
      Description

      Penerangan tentang apa yang tidak kena.

  • Name
    printability
    Type
    object
    Description

    Hasil analisis. Ia tidak wujud sehingga tugas berstatus SUCCEEDED.

    • Name
      _version
      Type
      string
      Description

      Versi skema bagi hasil kebolehcetakan. Nilainya ialah v1.

    • Name
      status
      Type
      string
      Description

      Keputusan keseluruhan, salah satu daripada:

      • healthy: tiada ralat dan tiada amaran
      • warning: sekurang-kurangnya satu amaran, dan tiada ralat
      • error: sekurang-kurangnya satu ralat
      • unknown: Meshy tidak dapat menganalisis model

      Apabila Meshy menyemak ketebalan dinding, ini adalah yang paling teruk antara semakan jejaring dan thin_walls.status. Daripada paling teruk kepada paling baik, susunannya ialah error, warning, unknown, dan healthy.

    • Name
      issue_count
      Type
      integer
      Description

      Jumlah bilangan isu, bersamaan dengan error_count + warning_count.

    • Name
      error_count
      Type
      integer
      Description

      Bilangan isu peringkat ralat. Meshy mengira satu ralat untuk setiap satu daripada perkara berikut:

      • Model tidak kedap air dan mempunyai lebih daripada 8 lubang.
      • Model mempunyai lebih daripada 8 lubang.
      • Isipadu adalah sifar atau kurang.
      • Model mempunyai lebih daripada 50 tepi non-manifold.

      Apabila Meshy menyemak ketebalan dinding, dinding yang terlalu nipis (thin_walls.status adalah error) dikira sebagai satu ralat tambahan.

    • Name
      warning_count
      Type
      integer
      Description

      Bilangan isu peringkat amaran. Meshy mengira satu amaran untuk setiap satu daripada perkara berikut:

      • Model tidak kedap air dan mempunyai 8 lubang atau kurang.
      • Model mempunyai 1 hingga 8 lubang.
      • Model mempunyai 1 hingga 50 tepi non-manifold.
      • Model mempunyai muka degenerat.
    • Name
      metrics
      Type
      object
      Description

      Ukuran geometri mentah bagi model.

      • Name
        is_watertight
        Type
        boolean
        Description

        true apabila jejaring tidak mempunyai tepi sempadan, iaitu, apabila ia tertutup.

      • Name
        volume
        Type
        number
        Description

        Isipadu model, dalam meter padu.

      • Name
        non_manifold_edges
        Type
        integer
        Description

        Bilangan tepi non-manifold.

      • Name
        degenerate_faces
        Type
        integer
        Description

        Bilangan muka degenerat, iaitu muka dengan keluasan sifar atau muka yang tidak sah.

      • Name
        holes
        Type
        integer
        Description

        Bilangan lubang dalam jejaring, dikira sebagai gelung sempadan.

    • Name
      intended_print
      Type
      object
      Description

      Pencetak dan saiz yang digunakan oleh semakan ketebalan dinding. Hadir hanya apabila Meshy menyemak ketebalan dinding.

      • Name
        printer_type
        Type
        string
        Description

        Jenis pencetak, fdm, sla, atau full_color.

      • Name
        height_mm
        Type
        number
        Description

        Ketinggian cetakan, dalam milimeter, apabila cetakan disaizkan mengikut ketinggian. Jika tidak, ia adalah null.

      • Name
        longest_side_mm
        Type
        number
        Description

        Panjang sisi terpanjang bagi cetakan, dalam milimeter. Apabila cetakan disaizkan mengikut ketinggian, Meshy mengiranya daripada perkadaran model.

      • Name
        wall_thickness_mm
        Type
        number
        Description

        Ketebalan dinding minimum untuk printer_type, dalam milimeter. Meshy melaporkan dinding yang lebih nipis sebagai terlalu nipis.

      • Name
        dimensions_mm
        Type
        array
        Description

        [lebar, kedalaman, ketinggian] cetakan, dalam milimeter. Ketinggian boleh berbeza daripada height_mm dengan sebahagian kecil milimeter. Ia adalah null untuk input selain GLB, atau apabila Meshy tidak dapat menentukan saiz model.

    • Name
      thin_walls
      Type
      object
      Description

      Hasil semakan ketebalan dinding. Hadir hanya apabila Meshy menyemak ketebalan dinding.

      • Name
        thin_area_ratio
        Type
        number
        Description

        Bahagian permukaan yang lebih nipis daripada intended_print.wall_thickness_mm, daripada 0 hingga 1. Ia adalah null apabila Meshy tidak dapat mengukur model.

      • Name
        has_thin_walls
        Type
        boolean
        Description

        true jika mana-mana bahagian permukaan terlalu nipis. Sudut tajam sahaja boleh menjadikannya true, jadi gunakan status untuk menentukan sama ada dinding perlu ditebalkan. Ia adalah null apabila Meshy tidak dapat mengukur model.

      • Name
        status
        Type
        string
        Description

        Keputusan ketebalan dinding, salah satu daripada:

        • healthy: 5% atau kurang daripada permukaan terlalu nipis.
        • error: lebih daripada 5% permukaan terlalu nipis. Untuk menebalkan dinding, hantar id tugas ini ke Baiki kebolehcetakan sebagai input_task_id. Jika tugas ini menganalisis fail .stl, .fbx, atau .gltf daripada model_url, hantar fail tersebut sebagai model_url sebaliknya.
        • unknown: Meshy tidak dapat mengukur model. Jika semakan ketebalan dinding itu sendiri gagal, tugas berakhir sebagai FAILED.
    • Name
      evaluated_at
      Type
      timestamp
      Description

      Masa Meshy mengira analisis, dalam milisaat Unix.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang digunakan oleh tugas. Ia sentiasa 0, kerana analisis adalah percuma.