lowpoly dihentikan pada 30 Okt 2026. Ganti model sebelum tanggal-tanggal ini agar permintaan tidak error. Lihat semua penghentian

API Analisis kemampuan cetak

Periksa model 3D untuk masalah pencetakan dengan mengukur kekedapan air (watertightness), volume, lubang, tepi non-manifold, dan permukaan degenerasi. Anda juga dapat memeriksa ketebalan dinding pada ukuran yang Anda rencanakan untuk dicetak.


POST/openapi/v1/print/analyze

Create an Analyze Printability task

Membuat tugas Analisis kemampuan cetak, yang mengevaluasi model 3D dan melaporkan metrik kemampuan cetaknya. Tugas ini berjalan di latar belakang. Untuk mengetahui berapa lama tugas biasanya berlangsung, lihat Processing times.

Ketika Meshy sudah memiliki hasil kemampuan cetak untuk tugas input_task_id, tugas baru tersebut langsung siap. GET pertama Anda pada tugas itu akan mengembalikan hasilnya.

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
    Wajib
    Description

    Wajib kecuali Anda mengirim model_url. ID tugas yang modelnya ingin Anda analisis. Tugas tersebut harus berstatus SUCCEEDED, dan merupakan milik Anda atau berada di ruang kerja yang Anda ikuti.

    Tugas ini bisa berupa salah satu dari jenis tugas berikut, menggunakan Meshy 6 atau lebih baru, termasuk Meshy 7:

    Tugas Repair Printability juga dapat digunakan.

  • Name
    model_url
    Type
    string
    Wajib
    Description

    Wajib kecuali Anda mengirim input_task_id. Model yang akan dianalisis, berupa URL publik atau data URI. Jika Anda mengirim keduanya, Meshy akan menggunakan input_task_id.

    Dari URL http atau https, model harus berupa file .glb, .gltf, .obj, .fbx, atau .stl dengan ukuran maksimum 400 MB. Data URI hanya dapat menampung file base64 GLB (data:model/gltf-binary;base64,...) atau glTF (data:model/gltf+json;base64,...) dengan ukuran maksimum 100 MB. Kirim file .obj, .fbx, atau .stl sebagai URL http atau https.

    File yang berukuran di atas 100 MB juga harus mengikuti aturan berikut:

    • File GLB, glTF, FBX, atau OBJ dapat memiliki maksimum 10.000.000 face. Meshy menghitung face sebagai segitiga, sehingga quad dihitung sebagai 2, dan mesh yang digambar lebih dari sekali dihitung sekali per salinan.
    • File FBX harus berupa FBX biner 7.1 atau lebih baru.
    • File GLB atau glTF tidak boleh menggunakan kompresi Draco.

    URL unduhan Meshy (assets.meshy.ai/…?Expires=…&Signature=…) telah ditandatangani dan berhenti berfungsi pada expires_at tugasnya. Membaca ulang tugas tersebut tidak memperbarui masa berlakunya. Untuk model yang Anda buat dengan Meshy, kirim input_task_id sebagai gantinya, yang akan berfungsi selama Meshy menyimpan tugas sumbernya (lihat Asset retention). Untuk menggunakan model setelah itu, unduh sebelum expires_at dan kirim salinan Anda sendiri.

Untuk juga memeriksa ketebalan dinding pada ukuran yang Anda rencanakan untuk dicetak, kirim printer_type, ukuran cetak, atau keduanya. Hasilnya ada di printability.thin_walls. Memeriksa ketebalan dinding memerlukan waktu lebih lama, sehingga tugas biasanya tidak langsung siap, bahkan jika Meshy sebelumnya pernah menganalisis model tersebut.

  • Name
    printer_type
    Type
    string
    Description

    Printer yang akan Anda gunakan. Ini menentukan ketebalan dinding minimum untuk pemeriksaan ketebalan dinding. Jika Anda mengirim ukuran cetak 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: full-color, dinding minimum 2,0 mm

    Nilai lainnya akan mengembalikan 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    Tinggi hasil cetak, dalam milimeter, dari 1 hingga 1000. Nilai di luar rentang ini akan mengembalikan 400. Kirim ini atau intended_print_longest_side_mm, bukan keduanya.

    Parameter ini hanya berfungsi dengan input GLB. Untuk model_url yang bukan file .glb, kirim intended_print_longest_side_mm sebagai gantinya.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    Panjang sisi terpanjang hasil cetak, dalam milimeter, dari 1 hingga 1000. Nilai di luar rentang ini akan mengembalikan 400. Parameter ini berfungsi dengan semua format input.

Jika Anda mengirim printer_type tanpa ukuran, Meshy menggunakan ukuran cetak berikut:

  • File .glb atau input_task_id apa pun: tinggi 150 mm
  • File .stl: sisi terpanjang file itu sendiri, dibaca sebagai milimeter
  • File .obj, .fbx, atau .gltf: 150 mm pada sisi terpanjang

Untuk file STL dalam satuan lain, kirim intended_print_longest_side_mm.

Meshy membulatkan kedua ukuran cetak ke milimeter terdekat.

Hasil

Kolom result pada respons menyimpan ID dari tugas Analisis kemampuan cetak yang baru.

Mode kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Pesan kesalahan menunjukkan masalah apa yang ditemukan. Contohnya:

    • Missing parameter: Baik input_task_id maupun model_url tidak dikirim.
    • Invalid UUID: input_task_id bukan UUID yang valid.
    • Invalid model URL: model_url salah format, menggunakan skema yang tidak didukung, atau memiliki ekstensi file yang tidak didukung.
    • Model file too large: File model_url berukuran di atas 400 MB dari URL http atau https, atau di atas 100 MB sebagai data URI.
    • Too many faces: File model_url adalah file GLB, glTF, FBX, atau OBJ berukuran di atas 100 MB dengan lebih dari 10.000.000 face. Kurangi jumlah face, lalu kirim ulang filenya.
    • ASCII FBX over 100 MB: File model_url adalah FBX ASCII berukuran di atas 100 MB. Kirim sebagai FBX biner atau GLB.
    • Unreadable model file: File model_url berukuran di atas 100 MB, dan Meshy tidak dapat membaca header-nya. Misalnya, file tersebut adalah GLB atau glTF yang dikompresi dengan Draco, atau FBX biner yang lebih lama dari 7.1.
    • Model header too complex: File model_url berukuran di atas 100 MB, dan header-nya memiliki terlalu banyak mesh, node, atau record untuk diperiksa. Kurangi jumlah objek dalam file, lalu kirim ulang.
    • Model file can't be downloaded: model_url mengembalikan kesalahan, paling sering karena URL unduhan Meshy yang ditandatangani telah kedaluwarsa. Membaca ulang tugas akan mengembalikan URL yang sama dengan masa berlaku yang sama. Kirim salinan file Anda sendiri, atau kirim input_task_id selama Meshy masih menyimpan tugas sumbernya.
    • Task not succeeded: Tugas input_task_id masih tertunda, sedang berlangsung, atau gagal.
    • Invalid print size: intended_print_height_mm atau intended_print_longest_side_mm berada di luar rentang 1 hingga 1000, atau permintaan memiliki keduanya.
    • Unknown printer type: printer_type bukan fdm, sla, atau full_color.
    • Height on a non-GLB model: Permintaan memiliki intended_print_height_mm dan model_url yang bukan file .glb. Kirim intended_print_longest_side_mm sebagai gantinya.
    • Can't size this model by height: Pada tinggi yang diminta, atau tinggi default 150 mm, sisi terpanjang model akan berada di luar rentang 1 hingga 1.000 mm. Hal ini juga terjadi ketika model berbentuk datar, atau ketika Meshy tidak dapat menentukan ukurannya. Kirim intended_print_longest_side_mm sebagai gantinya. Untuk model_url berupa .glb dan beberapa tugas input_task_id, Meshy baru menemukan hal ini setelah tugas dimulai, dan tugas berakhir sebagai FAILED.
    • STL size unusable: Permintaan memiliki printer_type tanpa ukuran, dan Meshy tidak dapat membaca sisi terpanjang dari file .stl itu sendiri, atau sisi tersebut berada di luar rentang 1 hingga 1.000 mm. Kirim intended_print_longest_side_mm.

    Perbaiki permintaan, lalu kirim ulang. Lihat Errors.

  • Name
    401 - Unauthorized
    Description

    Kunci API tidak ada atau tidak valid. Periksa header Authorization.

  • Name
    403 - Forbidden
    Description

    input_task_id adalah model bas-relief, yang tidak dapat dianalisis oleh endpoint ini. Pesannya adalah This model type does not support this operation. Kirim model lain.

  • Name
    404 - Not Found
    Description

    Meshy tidak dapat menemukan model untuk dianalisis untuk input_task_id. Contohnya:

    • Tugas tidak ada, telah dihapus, atau bukan milik Anda atau tidak berada di ruang kerja yang Anda ikuti.
    • Tugas menggunakan model yang lebih lama dari Meshy 6, atau jenisnya tidak menghasilkan model 3D.
    • File model tugas tersebut sudah tidak lagi ada dalam penyimpanan.

    Pastikan input_task_id adalah tugas yang didukung dan merupakan milik Anda atau berada di salah satu ruang kerja Anda, atau kirim model sebagai model_url.

  • Name
    429 - Too Many Requests
    Description

    Anda melebihi batas laju Anda, atau Anda memiliki terlalu banyak tugas yang tertunda. Tunggu, lalu coba lagi. Lihat Rate limits.


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

Mendapatkan task Analisis kemampuan cetak

Mengembalikan task Analisis kemampuan cetak berdasarkan 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 task dari respons pembuatan.

Returns

Objek task Analisis kemampuan cetak. Kolom printability-nya tidak akan ada hingga task berstatus SUCCEEDED. Saat Meshy memeriksa ketebalan dinding, printability juga mencakup intended_print dan thin_walls.


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

Menghapus task Analisis kemampuan cetak

Menghapus permanen task Analisis kemampuan cetak, termasuk hasil yang tersimpan dalam cache. Anda tidak dapat membatalkan penghapusan.

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 path

  • Name
    id
    Type
    path
    Description

    ID task yang akan dihapus.

Status task

Menghapus task dengan status PENDING akan mengembalikan kredit yang digunakan saat Anda membuatnya.

Task dengan status IN_PROGRESS tidak dapat dihapus. Permintaan akan mengembalikan 409 Conflict, dan task akan terus berjalan. Meshy tidak mengembalikan kredit untuk task yang sudah mulai berjalan, sehingga menghapusnya akan membuat Anda kehilangan kredit sekaligus hasilnya. Tunggu hingga task mencapai status SUCCEEDED, FAILED, atau CANCELED, baru kemudian hapus.

Menghapus task dengan status akhir (SUCCEEDED, FAILED, atau CANCELED) tidak akan mengembalikan kreditnya.

Returns

200 OK ketika task berhasil dihapus, atau 409 Conflict ketika task berstatus IN_PROGRESS.


GET/openapi/v1/print/analyze

Daftar tugas Analisis kemampuan cetak

Mengembalikan daftar tugas Analisis kemampuan cetak 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
    default 1
    Description

    Nomor halaman yang akan dikembalikan, dimulai dari 1.

  • Name
    page_size
    Type
    integer
    default 10
    Description

    Jumlah tugas per halaman, hingga 100.

  • Name
    sort_by
    Type
    string
    Description

    Urutan pengurutan.

    Nilai yang tersedia:

    • +created_at: terlama lebih dulu
    • -created_at: terbaru lebih dulu

Returns

Daftar berhalaman dari objek tugas Analisis kemampuan cetak.


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

Streaming tugas Analisis kemampuan cetak

Mengalirkan pembaruan tugas Analisis kemampuan cetak 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 dari respons pembuatan.

Returns

Sebuah stream objek tugas Analisis kemampuan cetak sebagai Server-Sent Events.

Setiap event menyimpan objek tugas lengkap, dalam bentuk yang sama seperti yang dikembalikan oleh endpoint Get. Selama tugas berstatus PENDING atau IN_PROGRESS, kolom outputnya kosong (null, [], atau {}), dan finished_at bernilai 0. Meshy mengirimkan kolom printability hanya setelah tugas berstatus SUCCEEDED.


Objek tugas Analisis kemampuan cetak

Objek tugas Analisis kemampuan cetak menjelaskan satu analisis dari sebuah model 3D. Objek ini menyimpan status, progress, dan hasil kemampuan cetak saat tugas berhasil.

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. Perlakukan sebagai string buram, dan jangan bergantung pada formatnya.

  • Name
    type
    Type
    string
    Description

    Jenis tugas, selalu print-analyze.

  • Name
    status
    Type
    string
    Description

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

  • Name
    progress
    Type
    integer
    Description

    Seberapa banyak tugas telah selesai, dalam persentase. Nilainya 0 hingga tugas dimulai dan 100 saat tugas berhasil.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Jumlah tugas yang berada di depan tugas ini dalam antrean. Nilai ini hanya bermakna selama tugas berstatus PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

    Waktu tugas dibuat, dalam milidetik Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Waktu tugas dimulai, dalam milidetik Unix. Nilainya 0 hingga tugas dimulai.

  • Name
    finished_at
    Type
    timestamp
    Description

    Waktu tugas selesai, dalam milidetik Unix. Nilainya 0 hingga tugas selesai.

  • Name
    expires_at
    Type
    timestamp
    Description

    Waktu hasil tugas kedaluwarsa, dalam milidetik Unix. Nilainya 0 hingga tugas selesai.

  • Name
    task_error
    Type
    object
    Description

    Detail kesalahan saat tugas gagal. Nilainya null jika tugas belum gagal. Lihat Kesalahan.

    • Name
      message
      Type
      string
      Description

      Deskripsi tentang apa yang salah.

  • Name
    printability
    Type
    object
    Description

    Hasil dari analisis. Nilai ini tidak ada hingga tugas berstatus SUCCEEDED.

    • Name
      _version
      Type
      string
      Description

      Versi skema dari hasil kemampuan cetak. Nilainya adalah v1.

    • Name
      status
      Type
      string
      Description

      Vonis keseluruhan, salah satu dari:

      • healthy: tidak ada kesalahan dan tidak ada peringatan
      • warning: setidaknya ada satu peringatan, dan tidak ada kesalahan
      • error: setidaknya ada satu kesalahan
      • unknown: Meshy tidak dapat menganalisis model

      Saat Meshy memeriksa ketebalan dinding, ini adalah yang terburuk di antara pemeriksaan mesh dan thin_walls.status. Dari yang terburuk ke yang terbaik, urutannya adalah error, warning, unknown, dan healthy.

    • Name
      issue_count
      Type
      integer
      Description

      Jumlah total masalah, sama dengan error_count + warning_count.

    • Name
      error_count
      Type
      integer
      Description

      Jumlah masalah tingkat kesalahan. Meshy menghitung satu kesalahan untuk masing-masing hal berikut:

      • Model tidak kedap air (watertight) dan memiliki lebih dari 8 lubang.
      • Model memiliki lebih dari 8 lubang.
      • Volumenya nol atau kurang.
      • Model memiliki lebih dari 50 tepi non-manifold.

      Saat Meshy memeriksa ketebalan dinding, dinding yang terlalu tipis (thin_walls.status bernilai error) dihitung sebagai satu kesalahan tambahan.

    • Name
      warning_count
      Type
      integer
      Description

      Jumlah masalah tingkat peringatan. Meshy menghitung satu peringatan untuk masing-masing hal berikut:

      • Model tidak kedap air (watertight) dan memiliki 8 lubang atau kurang.
      • Model memiliki 1 hingga 8 lubang.
      • Model memiliki 1 hingga 50 tepi non-manifold.
      • Model memiliki permukaan degenerasi.
    • Name
      metrics
      Type
      object
      Description

      Pengukuran geometri mentah dari model.

      • Name
        is_watertight
        Type
        boolean
        Description

        true saat mesh tidak memiliki tepi batas, yaitu, saat mesh tersebut tertutup.

      • Name
        volume
        Type
        number
        Description

        Volume model, dalam meter kubik.

      • Name
        non_manifold_edges
        Type
        integer
        Description

        Jumlah tepi non-manifold.

      • Name
        degenerate_faces
        Type
        integer
        Description

        Jumlah permukaan degenerasi, yaitu permukaan dengan luas nol atau permukaan yang tidak valid.

      • Name
        holes
        Type
        integer
        Description

        Jumlah lubang dalam mesh, dihitung sebagai loop batas.

    • Name
      intended_print
      Type
      object
      Description

      Printer dan ukuran yang digunakan oleh pemeriksaan ketebalan dinding. Hanya ada saat Meshy memeriksa ketebalan dinding.

      • Name
        printer_type
        Type
        string
        Description

        Jenis printer, fdm, sla, atau full_color.

      • Name
        height_mm
        Type
        number
        Description

        Tinggi cetakan, dalam milimeter, saat ukuran cetakan ditentukan berdasarkan tinggi. Jika tidak, nilainya null.

      • Name
        longest_side_mm
        Type
        number
        Description

        Panjang sisi terpanjang dari cetakan, dalam milimeter. Saat ukuran cetakan ditentukan berdasarkan tinggi, Meshy menghitungnya dari proporsi model.

      • Name
        wall_thickness_mm
        Type
        number
        Description

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

      • Name
        dimensions_mm
        Type
        array
        Description

        [width, depth, height] dari cetakan, dalam milimeter. Tingginya dapat berbeda dari height_mm sebesar sebagian kecil milimeter. Nilainya null untuk input selain GLB, atau saat Meshy tidak dapat menentukan ukuran model.

    • Name
      thin_walls
      Type
      object
      Description

      Hasil dari pemeriksaan ketebalan dinding. Hanya ada saat Meshy memeriksa ketebalan dinding.

      • Name
        thin_area_ratio
        Type
        number
        Description

        Bagian dari permukaan yang lebih tipis dari intended_print.wall_thickness_mm, dari 0 hingga 1. Nilainya null saat Meshy tidak dapat mengukur model.

      • Name
        has_thin_walls
        Type
        boolean
        Description

        true jika ada bagian mana pun dari permukaan yang terlalu tipis. Sudut tajam saja dapat membuatnya menjadi true, jadi gunakan status untuk memutuskan apakah dinding perlu ditebalkan. Nilainya null saat Meshy tidak dapat mengukur model.

      • Name
        status
        Type
        string
        Description

        Vonis ketebalan dinding, salah satu dari:

        • healthy: 5% atau kurang dari permukaan terlalu tipis.
        • error: lebih dari 5% dari permukaan terlalu tipis. Untuk menebalkan dinding, kirim id dari tugas ini ke Perbaiki kemampuan cetak sebagai input_task_id. Jika tugas ini menganalisis file .stl, .fbx, atau .gltf dari model_url, kirim file tersebut sebagai model_url sebagai gantinya.
        • unknown: Meshy tidak dapat mengukur model. Jika pemeriksaan ketebalan dinding itu sendiri gagal, tugas berakhir sebagai FAILED.
    • Name
      evaluated_at
      Type
      timestamp
      Description

      Waktu Meshy menghitung analisis, dalam milidetik Unix.

  • Name
    consumed_credits
    Type
    integer
    Description

    Jumlah kredit yang digunakan tugas. Nilainya selalu 0, karena analisis gratis.