API Baiki kebolehcetakan
Baiki model 3D untuk kebolehcetakan — betulkan tepi non-manifold, muka degenerat, lubang, dan isu topology lain supaya jejaring sedia untuk dicetak. Secara pilihan, anda juga boleh menebalkan dinding yang terlalu nipis pada saiz yang anda rancang untuk dicetak.
Cipta Tugas Baiki Kebolehcetakan
Endpoint ini mencipta tugas baiki-kebolehcetakan baharu. Tugas ini menjalankan pembaikan topology pada model 3D dan mengembalikan versi yang kedap air dan sedia dicetak.
Tugas ini berjalan di latar belakang. Untuk tempoh masa yang biasanya diambil, lihat Masa Pemprosesan.
Format output sepadan dengan format input. Jika anda menghantar .stl melalui model_url, model_urls.stl dalam respons akan memegang jejaring yang telah dibaiki dan medan format lain akan kosong. Laluan input_task_id sentiasa membaca GLB tugas sumber, jadi outputnya ialah .glb.
Untuk turut menebalkan dinding yang terlalu nipis pada saiz yang anda rancang untuk dicetak, hantar printer_type, saiz cetakan, atau kedua-duanya. Dinding hanya ditebalkan apabila lebih daripada 5% permukaan terlalu nipis untuk pencetak tersebut. Model yang dibaiki mengekalkan skala asalnya; skalakannya dengan API Ubah Saiz, yang menggunakan meter (100 mm ialah 0.1).
Parameter
Hanya satu daripada input_task_id atau model_url yang diperlukan. Jika kedua-duanya diberikan, input_task_id diutamakan.
Tekstur sedia ada dikeluarkan semasa pembaikan disebabkan oleh perubahan geometri. Untuk menambah semula tekstur, gunakan API Retekstur pada model yang telah dibaiki.
- Name
- input_task_id
- Type
- string
- Diperlukan
- Description
ID bagi tugas yang berjaya yang anda miliki. Jenis tugas yang disokong: Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D, Remesh, Retekstur, dan Analisis Kebolehcetakan. Tugas tersebut mesti mempunyai status
SUCCEEDEDdan mesti telah menghasilkan aset GLB.Tugas analisis yang memeriksa ketebalan dinding turut menyalurkan pencetak dan saiznya, jadi pembaikan memeriksa ketebalan dinding, dan menebalkan dinding yang nipis, walaupun anda tidak menghantar kedua-duanya;
printer_typeatau saiz cetakan yang anda hantar akan menggantikan nilai tersebut. Tugas analisis yang dicipta daripadamodel_url.stl,.fbx, atau.gltftidak diterima: sebaliknya hantar fail tersebut sebagaimodel_url.
- Name
- model_url
- Type
- string
- Diperlukan
- Description
URL model 3D untuk dibaiki. Format yang disokong:
.glb,.gltf,.obj,.fbx,.stl. Gunakan URLhttpatauhttps, atau URLdata:base64 untuk GLB (data:model/gltf-binary;base64,...) atau glTF (data:model/gltf+json;base64,...). Fail.obj,.fbxdan.stlmesti dihantar sebagai URLhttpatauhttps.Saiz fail maksimum: 400 MB untuk URL
httpatauhttps, 100 MB untuk URIdata:.Fail GLB, glTF, FBX atau OBJ yang melebihi 100 MB boleh mempunyai paling banyak 10,000,000 permukaan. Permukaan dikira sebagai segi tiga: segi empat dikira sebagai 2, dan jejaring yang dilukis lebih daripada sekali dikira sekali bagi setiap salinan. Melebihi 100 MB, fail FBX mesti berbentuk FBX binari 7.1 atau lebih baharu, dan fail GLB atau glTF tidak boleh menggunakan pemampatan Draco.
URL muat turun Meshy (
assets.meshy.ai/…?Expires=…&Signature=…) ditandatangani dan berhenti berfungsi padaexpires_attugas tersebut; mendapatkan semula tugas tersebut tidak memperbaharuinya. Untuk model yang dijana dengan Meshy, hantarinput_task_idsebagai gantinya. Ia berfungsi selagi tugas sumber dikekalkan (lihat Pengekalan Aset). Untuk menggunakan semula model selepas itu, muat turunnya sebelumexpires_atdan hantar salinan anda sendiri.
- Name
- alpha_thumbnail
- Type
- boolean
- lalai false
- Description
Apabila ditetapkan kepada
true, tugas ini turut merender versi latar belakang telus (RGBA) bagi pratonton dan mengembalikannya sebagaialpha_thumbnail_urlpada respons GET. Medanthumbnail_urlsedia ada tidak berubah.
Hantar paling banyak satu daripada dua medan saiz cetakan. Jika anda menghantar printer_type tanpa saiz, dan tiada saiz digunakan semula daripada tugas analisis, saiz lalai ialah:
.glbdan mana-manainput_task_id: tinggi 150 mm..stl: sisi terpanjang fail itu sendiri, dibaca sebagai milimeter. Untuk STL dalam unit lain, hantarintended_print_longest_side_mm..obj,.fbx,.gltf: 150 mm pada sisi terpanjang.
- Name
- printer_type
- Type
- string
- Description
Pencetak yang anda rancang untuk digunakan. Ia menetapkan ketebalan dinding minimum yang disasarkan oleh pembaikan. Lalai kepada
fdmapabila anda menghantar saiz cetakan tanpanya, melainkan tugas analisis yang dihantar sebagaiinput_task_idmembekalkan pencetak tersebut.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.
- Name
- intended_print_height_mm
- Type
- number
- Description
Tinggi cetakan, dalam milimeter. Julat:
[1, 1000]. Dibundarkan kepada milimeter terdekat. Hanya input GLB.
- Name
- intended_print_longest_side_mm
- Type
- number
- Description
Panjang sisi terpanjang cetakan, dalam milimeter. Julat:
[1, 1000]. Dibundarkan kepada milimeter terdekat. Berfungsi dengan setiap format input.
Nilai Pulangan
Sifat result bagi respons mengandungi id bagi tugas baiki-kebolehcetakan yang baharu dicipta.
Mod Kegagalan
- Name
400 - Bad Request- Description
Permintaan tidak boleh diterima. Punca biasa:
- Parameter hilang: tiada
input_task_idmahupunmodel_urldiberikan. - UUID tidak sah:
input_task_idbukan UUID yang sah. - URL model tidak sah:
model_urlterbentuk tidak betul, menggunakan skema yang tidak disokong, atau mempunyai sambungan fail yang tidak disokong. - Fail model terlalu besar: badan
model_urlmelebihi 400 MB (URLhttpatauhttps) atau 100 MB (URIdata:). - Terlalu banyak permukaan:
model_urlialah fail GLB, glTF, FBX atau OBJ yang melebihi 100 MB dengan lebih daripada 10,000,000 permukaan. Kurangkan bilangan permukaan, kemudian hantar fail itu semula. - FBX ASCII melebihi 100 MB:
model_urlialah FBX ASCII yang melebihi 100 MB. Hantarnya sebagai FBX binari atau GLB. - Fail model tidak boleh dibaca:
model_urlmelebihi 100 MB dan pengepalanya tidak dapat dibaca, contohnya GLB atau glTF yang dimampatkan Draco, atau FBX binari lebih lama daripada 7.1. - Pengepala model terlalu kompleks:
model_urlmelebihi 100 MB dan pengepalanya mempunyai terlalu banyak jejaring, nod atau rekod untuk diperiksa. Kurangkan bilangan objek dalam fail, kemudian hantarnya semula. - Fail model tidak dapat dimuat turun:
model_urlmengembalikan ralat, selalunya kerana URL muat turun Meshy yang ditandatangani telah tamat tempoh. Mendapatkan semula tugas tersebut mengembalikan URL yang sama dengan tamat tempoh yang sama, jadi hantar salinan fail anda sendiri, atau gunakaninput_task_idselagi tugas sumber masih dikekalkan. - Tugas tidak berjaya: tugas yang dirujuk masih belum selesai, sedang berjalan, atau telah gagal.
- GLB hilang: tugas yang dirujuk tiada aset GLB untuk dibaiki.
- Saiz cetakan tidak sah:
intended_print_height_mmatauintended_print_longest_side_mmberada di luar[1, 1000], atau kedua-duanya telah dihantar. - Jenis pencetak tidak diketahui:
printer_typebukanfdm,sla, ataufull_color. - Tinggi pada model bukan GLB:
intended_print_height_mmdihantar bersamamodel_urlyang bukan.glb. Gunakanintended_print_longest_side_mmsebagai gantinya. - Tidak dapat menyaiz model ini mengikut tinggi: pada tinggi yang diminta (atau lalai 150 mm), sisi terpanjang model akan berada di luar
[1, 1000]mm, model itu rata, atau saiznya tidak dapat ditentukan. Gunakanintended_print_longest_side_mmsebagai gantinya. Untukmodel_url.glbdan sesetengah tugasinput_task_id, ini hanya dapat dikesan selepas tugas bermula, dan tugas tersebut berakhir denganFAILEDsebaliknya. - Saiz STL tidak boleh digunakan:
printer_typedihantar tanpa saiz, dan sisi terpanjang.stlitu sendiri tidak dapat dibaca atau berada di luar[1, 1000]mm. Hantarintended_print_longest_side_mm.
- Parameter hilang: tiada
- Name
401 - Unauthorized- Description
Pengesahan gagal. Sila semak kunci API anda.
- Name
402 - Payment Required- Description
Punca biasa:
- Pelan percuma: penciptaan tugas memerlukan pelan berbayar. Naik taraf di halaman langganan.
- Kredit tidak mencukupi: had kredit ruang kerja telah dicapai.
- Name
404 - Not Found- Description
Tugas yang dirujuk tidak wujud atau dimiliki oleh pengguna lain.
- Name
429 - Too Many Requests- Description
Anda telah melebihi kuota tugas tertangguh atau had kadar anda.
Request
# 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"
}
Dapatkan Tugas Baiki Kebolehcetakan
Endpoint ini mendapatkan tugas baiki kebolehcetakan mengikut ID-nya.
Parameter
- Name
- id
- Type
- path
- Description
ID tugas baiki kebolehcetakan yang hendak didapatkan.
Nilai Pulangan
Objek Tugas Baiki Kebolehcetakan. Blok model_urls akan kosong sehingga tugas mencapai status SUCCEEDED. Hanya medan model_urls yang sepadan dengan format input akan diisi. Baiki ketebalan dinding menyertakan intended_print dari permulaan, dan print_repair_report sebaik sahaja tugas berjaya.
Request
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
}
}
Padam Tugas Baiki Kebolehcetakan
Endpoint ini memadam secara kekal tugas baiki-kebolehcetakan beserta hasil keluarannya yang telah dibaiki. Tindakan ini tidak boleh dibatalkan.
Parameter Laluan
- Name
- id
- Type
- path
- Description
ID bagi tugas baiki-kebolehcetakan yang hendak dipadam.
Status Tugas
Tugas yang masih PENDING akan dipadam dan kredit yang digunakan semasa
penciptaan akan dikembalikan.
Tugas yang sudah IN_PROGRESS tidak boleh dipadam: permintaan akan
ditolak dengan 409 Conflict dan tugas tersebut akan terus berjalan. Kredit bagi tugas
yang telah pun dimulakan oleh pekerja (worker) tidak boleh dikembalikan, jadi memadamnya semasa ia
sedang berjalan akan mengakibatkan anda kehilangan kredit dan juga hasilnya. Tunggu sehingga ia
mencapai SUCCEEDED, FAILED atau CANCELED, kemudian padamkannya.
Tugas yang berada dalam keadaan akhir (SUCCEEDED, FAILED atau CANCELED) akan dipadam
tanpa bayaran balik.
Pulangan
Mengembalikan 200 OK apabila berjaya, atau 409 Conflict apabila tugas
sedang IN_PROGRESS.
Request
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."
}
Senaraikan Tugas Baiki Kebolehcetakan
Endpoint ini membolehkan anda mendapatkan senarai tugas baiki kebolehcetakan.
Parameter
Atribut pilihan
- Name
- page_num
- Type
- integer
- Description
Nombor halaman untuk penomboran halaman. Bermula dan lalai kepada
1.
- Name
- page_size
- Type
- integer
- Description
Had saiz halaman. Lalai kepada
10item. Maksimum yang dibenarkan ialah100item.
- Name
- sort_by
- Type
- string
- Description
Medan untuk diisih. Nilai yang tersedia:
+created_at: Isih mengikut masa penciptaan secara menaik.-created_at: Isih mengikut masa penciptaan secara menurun.
Pulangan
Mengembalikan senarai bernombor halaman bagi Objek Tugas Baiki Kebolehcetakan.
Request
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
}
]
Alirkan Tugas Baiki Kebolehcetakan
Endpoint ini mengalirkan kemas kini masa nyata untuk tugas baiki kebolehcetakan menggunakan Server-Sent Events (SSE).
Parameter
- Name
- id
- Type
- path
- Description
Pengecam unik untuk tugas baiki kebolehcetakan yang hendak dialirkan.
Hasil Pulangan
Mengembalikan aliran Objek Tugas Baiki Kebolehcetakan sebagai Server-Sent Events.
Setiap bingkai membawa objek tugas penuh untuk peringkat tersebut — bentuk yang sama
dengan yang dikembalikan oleh endpoint Get — jadi semasa tugas berstatus PENDING atau IN_PROGRESS,
medan hasil pulangan hanya belum diisi lagi (null, [] atau {}) dan
finished_at adalah null. Blok model_urls hanya dihantar sebaik sahaja tugas mencapai status SUCCEEDED.
Request
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 Tugasan Baiki Kebolehcetakan
- Name
- id
- Type
- string
- Description
Pengecam unik untuk tugasan. Walaupun kami menggunakan UUID k-sortable untuk id tugasan sebagai butiran pelaksanaan, anda tidak seharusnya membuat sebarang andaian tentang format id tersebut.
- Name
- type
- Type
- string
- Description
Jenis tugasan baiki kebolehcetakan. Nilainya ialah
print-repair.
- Name
- status
- Type
- string
- Description
Status tugasan. Nilai yang mungkin ialah salah satu daripada
PENDING,IN_PROGRESS,SUCCEEDED,FAILED,CANCELED.
- Name
- progress
- Type
- integer
- Description
Progress tugasan. Jika tugasan belum bermula lagi, sifat ini akan menjadi
0. Sebaik sahaja tugasan berjaya, ini akan menjadi100.
- Name
- preceding_tasks
- Type
- integer
- Description
Bilangan tugasan yang mendahului.
Nilai medan ini hanya bermakna jika status tugasan ialah
PENDING.
- Name
- created_at
- Type
- timestamp
- Description
Cap masa bila tugasan dicipta, dalam milisaat.
- Name
- started_at
- Type
- timestamp
- Description
Cap masa bila tugasan dimulakan, dalam milisaat. Jika tugasan belum dimulakan lagi, sifat ini akan menjadi
0.
- Name
- finished_at
- Type
- timestamp
- Description
Cap masa bila tugasan selesai, dalam milisaat. Jika tugasan belum selesai lagi, sifat ini akan menjadi
0.
- Name
- expires_at
- Type
- timestamp
- Description
Cap masa bila hasil tugasan akan luput daripada sistem, dalam milisaat.
0jika tugasan belum selesai lagi.
- Name
- task_error
- Type
- object
- Description
Maklumat ralat jika tugasan gagal. Sifat ini adalah
nulljika tugasan tidak gagal. Lihat Ralat untuk butiran lanjut.- Name
message- Type
- string
- Description
Mesej ralat yang menerangkan apa yang tidak kena.
- Name
- model_urls
- Type
- object
- Description
URL yang boleh dimuat turun untuk model 3D yang telah dibaiki. Hanya medan yang sepadan dengan format input yang diisi; medan format lain adalah rentetan kosong.
- Name
glb- Type
- string
- Description
URL yang boleh dimuat turun untuk GLB yang telah dibaiki. Diisi apabila input adalah GLB atau apabila
input_task_iddigunakan.
- Name
gltf- Type
- string
- Description
URL yang boleh dimuat turun untuk GLTF yang telah dibaiki. Diisi apabila input adalah muat naik GLTF.
- Name
fbx- Type
- string
- Description
URL yang boleh dimuat turun untuk FBX yang telah dibaiki. Diisi apabila input adalah muat naik FBX.
- Name
obj- Type
- string
- Description
URL yang boleh dimuat turun untuk OBJ yang telah dibaiki. Diisi apabila input adalah muat naik OBJ.
- Name
stl- Type
- string
- Description
URL yang boleh dimuat turun untuk STL yang telah dibaiki. Diisi apabila input adalah muat naik STL.
- Name
usdz- Type
- string
- Description
Dikhaskan untuk output USDZ. Sentiasa rentetan kosong untuk tugasan baiki kebolehcetakan.
- Name
3mf- Type
- string
- Description
Dikhaskan untuk output 3MF. Sentiasa rentetan kosong untuk tugasan baiki kebolehcetakan.
- Name
mtl- Type
- string
- Description
Dikhaskan untuk output MTL. Sentiasa rentetan kosong untuk tugasan baiki kebolehcetakan.
- Name
- thumbnail_url
- Type
- string
- Description
URL imej pratonton yang dirender daripada model yang telah dibaiki.
- Name
- alpha_thumbnail_url
- Type
- string
- Description
URL yang boleh dimuat turun untuk versi latar belakang lutsinar (RGBA) bagi
thumbnail_url. Hanya hadir apabila tugasan dicipta denganalpha_thumbnail: truedan pratonton lutsinar berjaya dirender; jika tidak, medan ini ditiadakan.
- Name
- texture_urls
- Type
- array
- Description
Sentiasa tatasusunan kosong. Pembaikan hanya mengekalkan geometri input dan tidak membakar semula tekstur.
- Name
- consumed_credits
- Type
- integer
- Description
Bilangan kredit yang digunakan oleh tugasan ini.
10sebaik sahaja tugasan mencapaiSUCCEEDED. Mengembalikan0untuk tugasanFAILED(kredit dikembalikan apabila gagal).
- Name
- intended_print
- Type
- object
- Description
Pencetak dan saiz yang digunakan oleh pembaikan, sama ada dihantar atau digunakan semula daripada tugasan analisis. Hadir pada pembaikan ketebalan dinding sejak awal (
PENDING); nilai yang belum diketahui adalahnull.- Name
printer_type- Type
- string
- Description
fdm,sla, ataufull_color.
- Name
height_mm- Type
- number
- Description
Ketinggian cetakan dalam milimeter, jika saiz cetakan ditentukan mengikut ketinggian. Jika tidak,
null.
- Name
longest_side_mm- Type
- number
- Description
Sisi terpanjang cetakan dalam milimeter. Apabila saiz ditentukan mengikut ketinggian, ia dikira daripada perkadaran model, dan adalah
nullsehingga model diukur.
- Name
wall_thickness_mm- Type
- number
- Description
Ketebalan dinding minimum untuk
printer_type, dalam milimeter.
- Name
dimensions_mm- Type
- array
- Description
[lebar, kedalaman, ketinggian]cetakan dalam milimeter. Ketinggian boleh berbeza daripadaheight_mmsebanyak sebahagian kecil milimeter.nullsehingga tugasan berjaya, dan sentiasanulluntuk input bukan GLB.
- Name
- print_repair_report
- Type
- object
- Description
Apa yang dilakukan oleh pembaikan ketebalan dinding. Hadir sebaik sahaja pembaikan ketebalan dinding berjaya.
- Name
route- Type
- string
- Description
Pembaikan mana yang dijalankan. Salah satu daripada:
thin_wall: lebih daripada 5% permukaan terlalu nipis, jadi penebalan dinding turut dijalankan (lihatapplied).topology: dinding sudah cukup tebal; hanya pembaikan topology yang dijalankan.topology_unmeasured: dinding tidak dapat diukur; hanya pembaikan topology yang dijalankan.
- Name
applied- Type
- boolean
- Description
Sama ada penebalan dinding mengubah jejaring. Hanya hadir apabila
routeialahthin_wall.
- Name
faces_before- Type
- integer
- Description
Bilangan permukaan jejaring input. Hanya hadir apabila
routeialahthin_wall.
- Name
faces_after- Type
- integer
- Description
Bilangan permukaan jejaring yang telah dibaiki. Hanya hadir apabila
routeialahthin_wall.
- Name
thin_area_ratio_before- Type
- number
- Description
Bahagian permukaan input, dari
0hingga1, yang lebih nipis daripadaintended_print.wall_thickness_mm. Ditiadakan jika input tidak dapat diukur.
- Name
thin_area_ratio_after- Type
- number
- Description
Bahagian yang sama, diukur pada model yang telah dibaiki. Ditiadakan jika tidak dapat diukur; tugasan tetap berjaya.
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
}
}