API Perbaiki kemampuan cetak

Perbaiki model 3D agar siap cetak — perbaiki tepi non-manifold, permukaan degenerasi, lubang, dan masalah topology lainnya sehingga mesh siap dicetak. Secara opsional, Anda juga dapat menebalkan dinding yang terlalu tipis pada ukuran yang direncanakan untuk dicetak.

POST/openapi/v1/print/repair

Buat Tugas Perbaiki Kemampuan Cetak

Endpoint ini membuat tugas perbaikan kemampuan cetak baru. Tugas ini menjalankan perbaikan topology pada model 3D dan mengembalikan versi watertight yang siap dicetak.

Tugas berjalan di latar belakang. Untuk mengetahui berapa lama biasanya proses ini berlangsung, lihat Waktu Pemrosesan.

Format output sama dengan format input. Jika Anda mengirim .stl melalui model_url, model_urls.stl pada respons akan berisi mesh yang telah diperbaiki dan field format lainnya akan kosong. Path input_task_id selalu membaca GLB dari tugas sumber, sehingga outputnya berupa .glb.

Untuk juga menebalkan dinding yang terlalu tipis pada ukuran yang Anda rencanakan untuk dicetak, kirim printer_type, ukuran cetak, atau keduanya. Dinding hanya ditebalkan jika lebih dari 5% permukaan terlalu tipis untuk printer tersebut. Model yang diperbaiki mempertahankan skala aslinya; ubah skalanya dengan API Ubah Ukuran, yang menggunakan satuan meter (100 mm adalah 0.1).

Parameter

Hanya salah satu dari input_task_id atau model_url yang wajib diisi. Jika keduanya diberikan, input_task_id yang diprioritaskan.

Tekstur yang sudah ada akan dihapus selama proses perbaikan karena adanya perubahan geometri. Untuk menambahkan kembali tekstur, gunakan API Retexture pada model yang telah diperbaiki.

Name
input_task_id
Type
string
Wajib
Description
ID dari tugas yang berhasil dan Anda miliki. Jenis tugas yang didukung: Gambar ke 3D, Multi-Gambar ke 3D, Teks ke 3D, Remesh, Retexture, dan Analisis kemampuan cetak. Tugas tersebut harus memiliki status SUCCEEDED dan harus telah menghasilkan aset GLB.
Tugas analisis yang memeriksa ketebalan dinding juga meneruskan informasi printer dan ukurannya, sehingga perbaikan akan memeriksa ketebalan dinding, dan menebalkan dinding yang tipis, bahkan jika Anda tidak mengirim keduanya; printer_type atau ukuran cetak yang Anda kirim akan menggantikan nilai tersebut. Tugas analisis yang dibuat dari model_url berupa .stl, .fbx, atau .gltf tidak diterima: kirim file tersebut sebagai model_url sebagai gantinya.

Name
model_url
Type
string
Wajib
Description
URL model 3D yang akan diperbaiki. Format yang didukung: .glb, .gltf, .obj, .fbx, .stl. Gunakan URL http atau https, atau URL base64 data: untuk GLB (data:model/gltf-binary;base64,...) atau glTF (data:model/gltf+json;base64,...). File .obj, .fbx, dan .stl harus dikirim sebagai URL http atau https.
Ukuran file maksimum: 400 MB untuk URL http atau https, 100 MB untuk URI data:.
File GLB, glTF, FBX, atau OBJ yang berukuran lebih dari 100 MB dapat memiliki paling banyak 10.000.000 wajah. Wajah dihitung sebagai segitiga: sebuah segi empat dihitung sebagai 2, dan mesh yang digambar lebih dari sekali dihitung sekali untuk setiap salinan. Di atas 100 MB, file FBX harus berupa FBX biner 7.1 atau yang lebih baru, dan file GLB atau glTF tidak boleh menggunakan kompresi Draco.
URL unduhan Meshy (assets.meshy.ai/…?Expires=…&Signature=…) bertanda tangan dan berhenti berfungsi pada expires_at tugas; mengambil tugas tersebut kembali tidak memperbarui masa berlakunya. Untuk model yang dihasilkan dengan Meshy, kirim input_task_id sebagai gantinya. Ini akan tetap berfungsi selama tugas sumber masih dipertahankan (lihat Retensi Aset). Untuk menggunakan kembali model setelah itu, unduh model tersebut sebelum expires_at dan kirim salinan Anda sendiri.

Name
alpha_thumbnail
Type
boolean
default false
Description
Jika disetel ke true, tugas tersebut juga akan merender versi pratinjau berlatar belakang transparan (RGBA) dan mengembalikannya sebagai alpha_thumbnail_url pada respons GET. Field thumbnail_url yang sudah ada tidak berubah.

Kirim paling banyak satu dari dua field ukuran cetak. Jika Anda mengirim printer_type tanpa ukuran, dan tidak ada ukuran yang digunakan kembali dari tugas analisis, ukuran default adalah:

.glb dan input_task_id apa pun: tinggi 150 mm.
.stl: sisi terpanjang dari file itu sendiri, dibaca sebagai milimeter. Untuk STL dengan satuan lain, kirim intended_print_longest_side_mm.
.obj, .fbx, .gltf: 150 mm pada sisi terpanjang.

Name
printer_type
Type
string
Description
Printer yang akan Anda gunakan. Ini menentukan ketebalan dinding minimum yang menjadi target perbaikan. Defaultnya adalah fdm saat Anda mengirim ukuran cetak tanpa menyertakannya, kecuali tugas analisis yang dikirim sebagai input_task_id menyediakan informasi printer.
Nilai yang tersedia:
- fdm: filamen, ketebalan dinding minimum 1,0 mm.
- sla: resin, ketebalan dinding minimum 0,8 mm.
- full_color: full-color, ketebalan dinding minimum 2,0 mm.
Name
intended_print_height_mm
Type
number
Description
Tinggi hasil cetak, dalam milimeter. Rentang: [1, 1000]. Dibulatkan ke milimeter terdekat. Hanya untuk input GLB.
Name
intended_print_longest_side_mm
Type
number
Description
Panjang sisi terpanjang hasil cetak, dalam milimeter. Rentang: [1, 1000]. Dibulatkan ke milimeter terdekat. Berfungsi dengan setiap format input.

Hasil yang Dikembalikan

Properti result pada respons berisi id dari tugas perbaikan kemampuan cetak yang baru dibuat.

Mode Kegagalan

Name
400 - Bad Request
Description
Permintaan tidak dapat diterima. Penyebab umum:
- Parameter hilang: baik input_task_id maupun model_url tidak diberikan.
- UUID tidak valid: input_task_id bukan UUID yang valid.
- URL model tidak valid: model_url salah format, menggunakan skema yang tidak didukung, atau memiliki ekstensi file yang tidak didukung.
- File model terlalu besar: isi model_url melebihi 400 MB (URL http atau https) atau 100 MB (URI data:).
- Terlalu banyak wajah: model_url adalah file GLB, glTF, FBX, atau OBJ berukuran lebih dari 100 MB dengan lebih dari 10.000.000 wajah. Kurangi jumlah wajah, lalu kirim ulang file tersebut.
- FBX ASCII melebihi 100 MB: model_url adalah FBX ASCII berukuran lebih dari 100 MB. Kirim sebagai FBX biner atau GLB.
- File model tidak dapat dibaca: model_url berukuran lebih dari 100 MB dan headernya tidak dapat dibaca, misalnya GLB atau glTF yang dikompresi Draco, atau FBX biner yang lebih lama dari 7.1.
- Header model terlalu kompleks: model_url berukuran lebih dari 100 MB dan headernya memiliki terlalu banyak mesh, node, atau record untuk diperiksa. Kurangi jumlah objek dalam file, lalu kirim ulang.
- File model tidak dapat diunduh: model_url mengembalikan kesalahan, paling sering karena URL unduhan Meshy yang bertanda tangan telah kedaluwarsa. Mengambil tugas kembali akan mengembalikan URL yang sama dengan masa berlaku yang sama, jadi kirim salinan Anda sendiri dari file tersebut, atau gunakan input_task_id selama tugas sumber masih dipertahankan.
- Tugas belum berhasil: tugas yang direferensikan masih pending, sedang diproses, atau gagal.
- GLB hilang: tugas yang direferensikan tidak memiliki aset GLB untuk diperbaiki.
- Ukuran cetak tidak valid: intended_print_height_mm atau intended_print_longest_side_mm berada di luar [1, 1000], atau keduanya dikirim.
- Jenis printer tidak dikenal: printer_type bukan fdm, sla, atau full_color.
- Tinggi pada model non-GLB: intended_print_height_mm dikirim dengan model_url yang bukan .glb. Gunakan intended_print_longest_side_mm sebagai gantinya.
- Tidak dapat mengatur ukuran model berdasarkan tinggi: pada tinggi yang diminta (atau default 150 mm), sisi terpanjang model akan berada di luar [1, 1000] mm, model tersebut datar, atau ukurannya tidak dapat ditentukan. Gunakan intended_print_longest_side_mm sebagai gantinya. Untuk model_url berupa .glb dan beberapa tugas input_task_id, hal ini baru diketahui setelah tugas dimulai, dan tugas tersebut akan berakhir dengan status FAILED.
- Ukuran STL tidak dapat digunakan: printer_type dikirim tanpa ukuran, dan sisi terpanjang dari file .stl itu sendiri tidak dapat dibaca atau berada di luar [1, 1000] mm. Kirim intended_print_longest_side_mm.
Name
401 - Unauthorized
Description
Autentikasi gagal. Silakan periksa kunci API Anda.
Name
402 - Payment Required
Description
Penyebab umum:
- Paket gratis: pembuatan tugas memerlukan paket berbayar. Tingkatkan paket Anda di halaman langganan.
- Kredit tidak cukup: batas kredit ruang kerja telah tercapai.
Name
404 - Not Found
Description
Tugas yang direferensikan tidak ada atau dimiliki oleh pengguna lain.
Name
429 - Too Many Requests
Description
Anda telah melebihi kuota tugas tertunda atau batas laju Anda.

Request

POST

/openapi/v1/print/repair

# Repair an existing task
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Or repair a model URL directly
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "model_url": "https://example.com/model.stl"
  }'

# Also thicken walls that are too thin for a 100 mm tall SLA print
curl https://api.meshy.ai/openapi/v1/print/repair \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "printer_type": "sla",
    "intended_print_height_mm": 100
  }'

Response

{
  "result": "0193bfc5-ee4f-73f8-8525-44b398884ce9"
}

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

Mengambil Tugas Perbaiki Kemampuan Cetak

Endpoint ini mengambil tugas perbaikan kemampuan cetak berdasarkan ID-nya.

Parameter

Name
id
Type
path
Description
ID dari tugas perbaikan kemampuan cetak yang akan diambil.

Returns

Repair Printability Task Object. Blok model_urls akan kosong sampai tugas mencapai status SUCCEEDED. Hanya field model_urls yang sesuai dengan format input yang akan terisi. Perbaikan ketebalan dinding menyertakan intended_print sejak awal, dan print_repair_report setelah tugas berhasil.

Request

GET

/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl https://api.meshy.ai/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Response (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}

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

Hapus Tugas Perbaiki Kemampuan Cetak

Endpoint ini secara permanen menghapus tugas perbaiki kemampuan cetak beserta hasil perbaikannya. Tindakan ini tidak dapat dibatalkan.

Parameter Jalur

Name
id
Type
path
Description
ID dari tugas perbaiki kemampuan cetak yang akan dihapus.

Status Tugas

Tugas yang masih berstatus PENDING akan dihapus dan kredit yang terpakai saat pembuatan akan dikembalikan.

Tugas yang sudah berstatus IN_PROGRESS tidak dapat dihapus: permintaan akan ditolak dengan 409 Conflict dan tugas akan tetap berjalan. Kredit untuk tugas yang sudah mulai dikerjakan oleh worker tidak dapat dikembalikan, sehingga menghapusnya di tengah proses akan membuat Anda kehilangan baik kredit maupun hasilnya. Tunggu hingga tugas mencapai status SUCCEEDED, FAILED, atau CANCELED, baru kemudian hapus.

Tugas dengan status akhir (SUCCEEDED, FAILED, atau CANCELED) akan dihapus tanpa pengembalian kredit.

Hasil Pengembalian

Mengembalikan 200 OK jika berhasil, atau 409 Conflict jika tugas berstatus IN_PROGRESS.

Request

DELETE

/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f

curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// 200 OK on success, with an empty body.
//
// 409 Conflict when the task is IN_PROGRESS — the task is left 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."
}

GET/openapi/v1/print/repair

List Repair Printability Tasks

Endpoint ini memungkinkan Anda untuk mengambil daftar tugas Perbaiki kemampuan cetak.

Parameter

Atribut opsional

Name
page_num
Type
integer
Description
Nomor halaman untuk paginasi. Dimulai dan default-nya adalah 1.
Name
page_size
Type
integer
Description
Batas jumlah item per halaman. Defaultnya adalah 10 item. Maksimum yang diizinkan adalah 100 item.
Name
sort_by
Type
string
Description
Bidang yang digunakan untuk pengurutan. Nilai yang tersedia:
- +created_at: Urutkan berdasarkan waktu pembuatan secara menaik (ascending).
- -created_at: Urutkan berdasarkan waktu pembuatan secara menurun (descending).

Returns

Mengembalikan daftar berpaginasi dari Repair Printability Task Objects.

Request

GET

/openapi/v1/print/repair

curl https://api.meshy.ai/openapi/v1/print/repair?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-repair",
    "status": "SUCCEEDED",
    "progress": 100,
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000030000,
    "expires_at": 1715725401000,
    "task_error": null,
    "model_urls": {
      "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
      "gltf": "",
      "fbx": "",
      "obj": "",
      "stl": "",
      "usdz": "",
      "3mf": "",
      "mtl": ""
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

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

Stream a Repair Printability Task

Endpoint ini melakukan streaming pembaruan secara real-time untuk tugas perbaikan kemampuan cetak menggunakan Server-Sent Events (SSE).

Parameter

Name
id
Type
path
Description
Pengenal unik untuk tugas perbaikan kemampuan cetak yang akan di-streaming.

Returns

Mengembalikan stream dari Objek Tugas Perbaiki kemampuan cetak sebagai Server-Sent Events.

Setiap frame membawa objek tugas lengkap untuk tahap tersebut — bentuk yang sama dengan yang dikembalikan oleh endpoint Get — sehingga selama tugas berstatus PENDING atau IN_PROGRESS, kolom output memang belum terisi (null, [] atau {}) dan finished_at bernilai null. Blok model_urls hanya dikirim setelah tugas mencapai status SUCCEEDED.

Request

GET

/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream

curl -N https://api.meshy.ai/openapi/v1/print/repair/a43b5c6d-7e8f-901a-234b-567c890d1e2f/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// Every frame is the full task object; fields not yet populated are null / empty.
// The PENDING frame below is abbreviated to the fields that change.
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Objek Task Repair Printability

Name
id
Type
string
Description
Pengenal unik untuk task. Meskipun kami menggunakan UUID yang dapat diurutkan-k untuk id task sebagai detail implementasi, Anda tidak boleh membuat asumsi apa pun tentang format id tersebut.
Name
type
Type
string
Description
Jenis task repair-printability. Nilainya adalah print-repair.
Name
status
Type
string
Description
Status task. Nilai yang mungkin adalah salah satu dari PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progress task. Jika task belum dimulai, properti ini akan bernilai 0. Setelah task berhasil, nilai ini akan menjadi 100.
Name
preceding_tasks
Type
integer
Description
Jumlah task yang mendahului.
Nilai dari field ini hanya bermakna jika status task adalah PENDING.
Name
created_at
Type
timestamp
Description
Stempel waktu kapan task dibuat, dalam milidetik.
Name
started_at
Type
timestamp
Description
Stempel waktu kapan task dimulai, dalam milidetik. Jika task belum dimulai, properti ini akan bernilai 0.
Name
finished_at
Type
timestamp
Description
Stempel waktu kapan task selesai, dalam milidetik. Jika task belum selesai, properti ini akan bernilai 0.
Name
expires_at
Type
timestamp
Description
Stempel waktu kapan hasil task akan kedaluwarsa dari sistem, dalam milidetik. 0 jika task belum selesai.
Name
task_error
Type
object
Description
Informasi kesalahan jika task gagal. Properti ini bernilai null jika task tidak gagal. Lihat Kesalahan untuk detail lebih lanjut.
- Name
  message
  Type
  string
  Description
  Pesan kesalahan yang menjelaskan apa yang salah.
Name
model_urls
Type
object
Description
URL yang dapat diunduh untuk model 3D yang telah diperbaiki. Hanya field yang sesuai dengan format input yang diisi; field format lainnya berupa string kosong.
- Name
  glb
  Type
  string
  Description
  URL yang dapat diunduh untuk GLB yang telah diperbaiki. Diisi ketika input berupa GLB atau ketika input_task_id digunakan.
- Name
  gltf
  Type
  string
  Description
  URL yang dapat diunduh untuk GLTF yang telah diperbaiki. Diisi ketika input berupa unggahan GLTF.
- Name
  fbx
  Type
  string
  Description
  URL yang dapat diunduh untuk FBX yang telah diperbaiki. Diisi ketika input berupa unggahan FBX.
- Name
  obj
  Type
  string
  Description
  URL yang dapat diunduh untuk OBJ yang telah diperbaiki. Diisi ketika input berupa unggahan OBJ.
- Name
  stl
  Type
  string
  Description
  URL yang dapat diunduh untuk STL yang telah diperbaiki. Diisi ketika input berupa unggahan STL.
- Name
  usdz
  Type
  string
  Description
  Dicadangkan untuk output USDZ. Selalu berupa string kosong untuk task repair-printability.
- Name
  3mf
  Type
  string
  Description
  Dicadangkan untuk output 3MF. Selalu berupa string kosong untuk task repair-printability.
- Name
  mtl
  Type
  string
  Description
  Dicadangkan untuk output MTL. Selalu berupa string kosong untuk task repair-printability.
Name
thumbnail_url
Type
string
Description
URL gambar pratinjau yang dirender dari model yang telah diperbaiki.
Name
alpha_thumbnail_url
Type
string
Description
URL yang dapat diunduh untuk versi latar belakang transparan (RGBA) dari thumbnail_url. Hanya ada ketika task dibuat dengan alpha_thumbnail: true dan pratinjau transparan berhasil dirender; jika tidak, field ini dihilangkan.
Name
texture_urls
Type
array
Description
Selalu berupa array kosong. Repair hanya mempertahankan geometri input dan tidak membuat ulang (re-bake) texture.
Name
consumed_credits
Type
integer
Description
Jumlah kredit yang terpakai oleh task ini. 10 setelah task mencapai status SUCCEEDED. Mengembalikan 0 untuk task FAILED (kredit dikembalikan jika gagal).
Name
intended_print
Type
object
Description
Jenis printer dan ukuran yang digunakan untuk repair, baik yang dikirimkan atau digunakan ulang dari task analyze. Ada pada repair ketebalan dinding sejak awal (PENDING); nilai yang belum diketahui akan berupa null.
- Name
  printer_type
  Type
  string
  Description
  fdm, sla, atau full_color.
- Name
  height_mm
  Type
  number
  Description
  Tinggi cetak dalam milimeter, jika hasil cetak diukur berdasarkan tinggi. Jika tidak, null.
- Name
  longest_side_mm
  Type
  number
  Description
  Sisi terpanjang dari hasil cetak dalam milimeter. Ketika diukur berdasarkan tinggi, nilai ini dihitung dari proporsi model, dan bernilai null hingga model diukur.
- Name
  wall_thickness_mm
  Type
  number
  Description
  Ketebalan dinding minimum untuk printer_type, dalam milimeter.
- Name
  dimensions_mm
  Type
  array
  Description
  Nilai [width, depth, height] hasil cetak dalam milimeter. Tinggi dapat berbeda dari height_mm sebesar sebagian kecil milimeter. Bernilai null hingga task berhasil, dan selalu null untuk input non-GLB.
Name
print_repair_report
Type
object
Description
Apa yang dilakukan oleh repair ketebalan dinding. Ada setelah repair ketebalan dinding berhasil.
- Name
  route
  Type
  string
  Description
  Repair mana yang dijalankan. Salah satu dari:
  
  thin_wall: lebih dari 5% permukaan terlalu tipis, sehingga penebalan dinding juga dijalankan (lihat applied).
  
  topology: dinding cukup tebal; hanya repair topology yang dijalankan.
  
  topology_unmeasured: dinding tidak dapat diukur; hanya repair topology yang dijalankan.
- Name
  applied
  Type
  boolean
  Description
  Apakah penebalan dinding mengubah mesh. Hanya ada ketika route bernilai thin_wall.
- Name
  faces_before
  Type
  integer
  Description
  Jumlah face dari mesh input. Hanya ada ketika route bernilai thin_wall.
- Name
  faces_after
  Type
  integer
  Description
  Jumlah face dari mesh yang telah diperbaiki. Hanya ada ketika route bernilai thin_wall.
- Name
  thin_area_ratio_before
  Type
  number
  Description
  Bagian dari permukaan input, dari 0 hingga 1, yang lebih tipis dari intended_print.wall_thickness_mm. Dihilangkan jika input tidak dapat diukur.
- Name
  thin_area_ratio_after
  Type
  number
  Description
  Bagian yang sama, diukur pada model yang telah diperbaiki. Dihilangkan jika tidak dapat diukur; task tetap berhasil.

The Repair Printability Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000030000,
  "expires_at": 1715725401000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

The Repair Printability Task Object (wall thickness checked)

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-repair",
  "status": "SUCCEEDED",
  "progress": 100,
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000090000,
  "expires_at": 1715725490000,
  "task_error": null,
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "gltf": "",
    "fbx": "",
    "obj": "",
    "stl": "",
    "usdz": "",
    "3mf": "",
    "mtl": ""
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10,
  "intended_print": {
    "printer_type": "sla",
    "height_mm": 100,
    "longest_side_mm": 118,
    "wall_thickness_mm": 0.8,
    "dimensions_mm": [118, 72.41, 99.87]
  },
  "print_repair_report": {
    "route": "thin_wall",
    "applied": true,
    "faces_before": 243112,
    "faces_after": 251870,
    "thin_area_ratio_before": 0.083,
    "thin_area_ratio_after": 0.004
  }
}