Repair Printability API

Ayusin ang isang 3D na modelo para sa printability — ayusin ang non-manifold edges, degenerate faces, mga butas, at iba pang isyu sa topology upang maging handa sa pag-print ang mesh. Opsyonal, mapalapot din ang mga pader na masyadong manipis sa laki na balak mong i-print.

POST/openapi/v1/print/repair

Create a Repair Printability Task

Ang endpoint na ito ay lumilikha ng bagong repair-printability task. Pinapatakbo ng task na ito ang topology repair sa isang 3D model at nagbabalik ng watertight, print-ready na bersyon.

Tumatakbo ang task sa background. Para malaman kung gaano karaming oras karaniwang aabutin, tingnan ang Processing Times.

Ang output format ay tumutugma sa input format. Kung magsusumite ka ng .stl sa pamamagitan ng model_url, ang model_urls.stl ng response ang magkakaroon ng naayos (repaired) na mesh at ang ibang format fields ay magiging walang laman. Ang input_task_id path ay palaging binabasa ang GLB ng source task, kaya ang output ay .glb.

Para palapot din ang mga dingding na masyadong manipis sa size na plano mong i-print, magpadala ng printer_type, isang print size, o pareho. Papalapatin lamang ang mga dingding kapag higit sa 5% ng surface ang masyadong manipis para sa printer na iyon. Pinapanatili ng naayos na model ang orihinal nitong scale; i-scale ito gamit ang Resize API, na tumatanggap ng meters (ang 100 mm ay 0.1).

Mga Parameter

Isa lamang sa input_task_id o model_url ang kinakailangan. Kung parehong ibinigay, ang input_task_id ang mauuna.

Inaalis ang mga umiiral nang texture sa panahon ng repair dahil sa pagbabago ng heometriya. Para maidagdag muli ang mga texture, gamitin ang Retexture API sa naayos na model.

Name
input_task_id
Type
string
Kinakailangan
Description
Ang ID ng matagumpay na task na pagmamay-ari mo. Suportadong uri ng task: Image to 3D, Multi-Image to 3D, Text to 3D, Remesh, Retexture, at Analyze Printability. Dapat ang status ng task ay SUCCEEDED at dapat itong nakalikha ng GLB asset.
Ang isang analyze task na sumuri ng kapal ng dingding ay ipinapasa rin ang printer at size nito, kaya sinusuri ng repair ang kapal ng dingding, at pinapalapot ang manipis na mga dingding, kahit wala kang ipadala sa dalawa; ang printer_type o print size na ipinadala mo ay magpapalit sa halagang iyon. Hindi tinatanggap ang mga analyze task na nilikha mula sa .stl, .fbx, o .gltf na model_url: ipadala na lamang ang file bilang model_url.

Name
model_url
Type
string
Kinakailangan
Description
URL ng 3D model na aayusin. Suportadong format: .glb, .gltf, .obj, .fbx, .stl. Gumamit ng http o https URL, o base64 na data: URL para sa GLB (data:model/gltf-binary;base64,...) o glTF (data:model/gltf+json;base64,...). Ang mga .obj, .fbx at .stl file ay dapat ipadala bilang http o https URL.
Pinakamalaking laki ng file: 400 MB para sa http o https URL, 100 MB para sa data: URI.
Ang isang GLB, glTF, FBX o OBJ file na higit sa 100 MB ay maaaring magkaroon ng pinakamarami na 10,000,000 faces. Binibilang ang mga face bilang triangles: ang isang quad ay binibilang bilang 2, at ang mesh na iginuhit nang higit sa isang beses ay binibilang isang beses kada kopya. Higit sa 100 MB, ang FBX file ay dapat binary FBX 7.1 o mas bago, at ang GLB o glTF file ay hindi dapat gumamit ng Draco compression.
Ang mga download URL ng Meshy (assets.meshy.ai/…?Expires=…&Signature=…) ay nilagdaan (signed) at hindi na gumagana sa expires_at ng task; ang muling pagkuha sa task ay hindi na nire-renew ang mga ito. Para sa model na nilikha gamit ang Meshy, ipasa na lamang ang input_task_id. Gumagana ito habang nananatili ang source task (tingnan ang Asset Retention). Para magamit muli ang model pagkatapos nito, i-download ito bago ang expires_at at ipadala ang sarili mong kopya.

Name
alpha_thumbnail
Type
boolean
default false
Description
Kapag itinakda sa true, ang task ay karagdagang nagre-render ng transparent-background (RGBA) na bersyon ng preview at ibinabalik ito bilang alpha_thumbnail_url sa GET response. Hindi nagbabago ang umiiral nang field na thumbnail_url.

Magpadala ng pinakamarami na isa sa dalawang print size field. Kung magpapadala ka ng printer_type nang walang size, at walang size na nagamit muli mula sa analyze task, ang default na size ay:

.glb at anumang input_task_id: 150 mm ang taas.
.stl: ang sarili nitong pinakamahabang gilid, binabasa bilang millimeters. Para sa STL na nasa ibang unit, ipadala ang intended_print_longest_side_mm.
.obj, .fbx, .gltf: 150 mm sa pinakamahabang gilid.

Name
printer_type
Type
string
Description
Ang printer na plano mong gamitin. Itinatakda nito ang minimum na kapal ng dingding na tinatarget ng repair. Default sa fdm kapag nagpapadala ka ng print size nang wala ito, maliban na lamang kung ang analyze task na ipinasa bilang input_task_id ay nagbibigay ng printer.
Mga available na halaga:
- fdm: filament, 1.0 mm minimum na dingding.
- sla: resin, 0.8 mm minimum na dingding.
- full_color: full-color, 2.0 mm minimum na dingding.
Name
intended_print_height_mm
Type
number
Description
Taas ng print, sa millimeters. Saklaw: [1, 1000]. Binibilog sa pinakamalapit na millimeter. GLB input lamang.
Name
intended_print_longest_side_mm
Type
number
Description
Haba ng pinakamahabang gilid ng print, sa millimeters. Saklaw: [1, 1000]. Binibilog sa pinakamalapit na millimeter. Gumagana sa lahat ng input format.

Mga Ibinabalik

Ang result property ng response ay naglalaman ng id ng bagong likhang repair-printability task.

Mga Mode ng Pagkabigo

Name
400 - Bad Request
Description
Hindi katanggap-tanggap ang request. Karaniwang sanhi:
- Nawawalang parameter: wala sa input_task_id o model_url ang naibigay.
- Hindi wastong UUID: ang input_task_id ay hindi isang wastong UUID.
- Hindi wastong model URL: ang model_url ay malformed, gumagamit ng hindi suportadong scheme, o may hindi suportadong file extension.
- Masyadong malaki ang model file: ang model_url body ay lumampas sa 400 MB (http o https URL) o 100 MB (data: URI).
- Masyadong maraming face: ang model_url ay isang GLB, glTF, FBX o OBJ file na higit sa 100 MB na may higit sa 10,000,000 face. Bawasan ang bilang ng face, pagkatapos ay ipadala muli ang file.
- ASCII FBX na higit sa 100 MB: ang model_url ay isang ASCII FBX na higit sa 100 MB. Ipadala ito bilang binary FBX o GLB.
- Hindi mabasang model file: ang model_url ay higit sa 100 MB at hindi mabasa ang header nito, halimbawa ay isang Draco-compressed GLB o glTF, o isang binary FBX na mas luma sa 7.1.
- Masyadong komplikado ang model header: ang model_url ay higit sa 100 MB at ang header nito ay may masyadong maraming mesh, node, o record na susuriin. Bawasan ang bilang ng mga object sa file, pagkatapos ay ipadala muli ito.
- Hindi ma-download ang model file: nagbalik ng error ang model_url, kadalasan dahil nag-expire na ang nilagdaang (signed) Meshy download URL. Ang muling pagkuha sa task ay nagbabalik ng parehong URL na may parehong expiry, kaya ipadala ang sarili mong kopya ng file, o gamitin ang input_task_id habang nananatili pa ang source task.
- Hindi matagumpay ang task: ang tinutukoy na task ay nasa pending pa, isinasagawa, o nabigo.
- Nawawalang GLB: ang tinutukoy na task ay walang GLB asset na aayusin.
- Hindi wastong print size: ang intended_print_height_mm o intended_print_longest_side_mm ay wala sa loob ng [1, 1000], o parehong ipinadala.
- Hindi kilalang printer type: ang printer_type ay hindi fdm, sla, o full_color.
- Height sa hindi GLB na model: ipinadala ang intended_print_height_mm kasama ang model_url na hindi .glb. Gamitin na lamang ang intended_print_longest_side_mm.
- Hindi masukat ang model na ito ayon sa height: sa hiniling na height (o ang default na 150 mm), ang pinakamahabang gilid ng model ay magiging wala sa loob ng [1, 1000] mm, ang model ay patag, o hindi matukoy ang size nito. Gamitin na lamang ang intended_print_longest_side_mm. Para sa .glb na model_url at ilang input_task_id na task, natutuklasan lamang ito pagkatapos magsimula ang task, at ang task ay nagtatapos sa FAILED sa halip.
- Hindi magagamit ang STL size: ipinadala ang printer_type nang walang size, at ang sariling pinakamahabang gilid ng .stl ay hindi mabasa o wala sa loob ng [1, 1000] mm. Ipadala ang intended_print_longest_side_mm.
Name
401 - Unauthorized
Description
Nabigo ang authentication. Mangyaring suriin ang iyong API key.
Name
402 - Payment Required
Description
Karaniwang sanhi:
- Libreng plano: nangangailangan ang paglikha ng task ng bayad na plano. Mag-upgrade sa subscription page.
- Hindi sapat na credits: naabot na ang credit limit ng workspace.
Name
404 - Not Found
Description
Ang tinutukoy na task ay hindi umiiral o pagmamay-ari ng ibang user.
Name
429 - Too Many Requests
Description
Nalampasan mo na ang iyong pending-task quota o rate limit.

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

Pagkuha ng Repair Printability Task

Ang endpoint na ito ay kumukuha ng repair-printability task gamit ang ID nito.

Mga Parameter

Name
id
Type
path
Description
Ang ID ng repair-printability task na kukunin.

Ibinabalik

Ang Repair Printability Task Object. Walang laman ang bloke ng model_urls hanggang maabot ng task ang SUCCEEDED. Ang field lang na model_urls na tumutugma sa format ng input ang mapupunan. Ang pag-repair ng kapal ng dingding ay may kasamang intended_print mula sa simula, at print_repair_report kapag nagtagumpay na ang task.

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

Burahin ang Repair Printability Task

Ang endpoint na ito ay permanenteng magbubura ng isang repair-printability task at ng na-repair na output nito. Hindi na maibabalik ang aksyong ito.

Mga Path Parameter

Name
id
Type
path
Description
Ang ID ng repair-printability task na ibubura.

Status ng Task

Ang isang task na nasa PENDING pa ay buburahin at ire-refund ang mga credits na nagamit noong oras ng paglikha nito.

Ang isang task na IN_PROGRESS na ay hindi maaaring burahin: tatanggihan ang request na may 409 Conflict at magpapatuloy pa ring tumakbo ang task. Hindi na-refund ang mga credits para sa isang task na nasimulan na ng worker, kaya ang pagbura rito habang tumatakbo ay magiging dahilan ng pagkawala ng iyong credits at ng resulta. Hintayin na maabot nito ang SUCCEEDED, FAILED, o CANCELED, bago ito burahin.

Ang isang task na nasa terminal na estado (SUCCEEDED, FAILED, o CANCELED) ay buburahin nang walang refund.

Mga Ibinabalik

Nagbabalik ng 200 OK kapag matagumpay, o 409 Conflict kapag ang task ay 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

Ilista ang mga Gawaing Repair Printability

Ang endpoint na ito ay nagbibigay-daan sa iyo na kunin ang isang listahan ng mga gawaing repair-printability.

Mga Parameter

Opsyonal na mga katangian

Name
page_num
Type
integer
Description
Numero ng pahina para sa pagination. Nagsisimula at nakatakda bilang default sa 1.
Name
page_size
Type
integer
Description
Limitasyon ng laki ng pahina. Default ay 10 na mga item. Ang pinakamataas na pinapayagan ay 100 na mga item.
Name
sort_by
Type
string
Description
Field na gagamitin sa pag-aayos. Mga available na halaga:
- +created_at: Ayusin ayon sa oras ng paglikha pataas.
- -created_at: Ayusin ayon sa oras ng paglikha pababa.

Ibinabalik

Nagbabalik ng isang paginated na listahan ng 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

I-stream ang Repair Printability Task

Ang endpoint na ito ay nag-i-stream ng real-time na mga update para sa isang repair-printability task gamit ang Server-Sent Events (SSE).

Mga Parameter

Name
id
Type
path
Description
Natatanging identifier para sa repair-printability task na i-stream.

Ibinabalik

Nagbabalik ng isang stream ng Repair Printability Task Objects bilang Server-Sent Events.

Bawat frame ay nagdadala ng kumpletong task object para sa yugto — ang parehong anyo na ibinabalik ng Get endpoint — kaya habang ang task ay PENDING o IN_PROGRESS ang mga output field ay hindi pa simpleng napupuno (null, [] o {}) at ang finished_at ay null. Ang model_urls block ay ipinapadala lamang kapag naabot ng task ang 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
}

The Repair Printability Task Object

Name
id
Type
string
Description
Natatanging identifier para sa task. Bagama't gumagamit kami ng k-sortable UUID para sa mga task id bilang detalye ng implementasyon, hindi mo dapat gawin ang anumang palagay tungkol sa format ng id.
Name
type
Type
string
Description
Uri ng repair-printability task. Ang value ay print-repair.
Name
status
Type
string
Description
Status ng task. Ang posibleng mga value ay isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.
Name
progress
Type
integer
Description
Progress ng task. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0. Kapag nagtagumpay na ang task, ito ay magiging 100.
Name
preceding_tasks
Type
integer
Description
Ang bilang ng mga paunang (preceding) task.
Makabuluhan lamang ang value ng field na ito kung ang status ng task ay PENDING.
Name
created_at
Type
timestamp
Description
Timestamp kung kailan nilikha ang task, sa milliseconds.
Name
started_at
Type
timestamp
Description
Timestamp kung kailan nagsimula ang task, sa milliseconds. Kung hindi pa nasisimulan ang task, ang property na ito ay magiging 0.
Name
finished_at
Type
timestamp
Description
Timestamp kung kailan natapos ang task, sa milliseconds. Kung hindi pa natatapos ang task, ang property na ito ay magiging 0.
Name
expires_at
Type
timestamp
Description
Timestamp kung kailan mag-e-expire ang resulta ng task mula sa sistema, sa milliseconds. 0 kung hindi pa natatapos ang task.
Name
task_error
Type
object
Description
Impormasyon ng error kung nabigo ang task. Ang property na ito ay null kung hindi nabigo ang task. Tingnan ang Errors para sa karagdagang detalye.
- Name
  message
  Type
  string
  Description
  Mensahe ng error na naglalarawan kung ano ang nagkamali.
Name
model_urls
Type
object
Description
Mga downloadable URL patungo sa naayos (repaired) na 3D model. Ang field lamang na tumutugma sa format ng input ang napopopulate; ang ibang format fields ay mga blangkong string.
- Name
  glb
  Type
  string
  Description
  Downloadable URL patungo sa naayos na GLB. Napopopulate kapag ang input ay isang GLB o kapag ginamit ang input_task_id.
- Name
  gltf
  Type
  string
  Description
  Downloadable URL patungo sa naayos na GLTF. Napopopulate kapag ang input ay isang GLTF upload.
- Name
  fbx
  Type
  string
  Description
  Downloadable URL patungo sa naayos na FBX. Napopopulate kapag ang input ay isang FBX upload.
- Name
  obj
  Type
  string
  Description
  Downloadable URL patungo sa naayos na OBJ. Napopopulate kapag ang input ay isang OBJ upload.
- Name
  stl
  Type
  string
  Description
  Downloadable URL patungo sa naayos na STL. Napopopulate kapag ang input ay isang STL upload.
- Name
  usdz
  Type
  string
  Description
  Nakalaan para sa USDZ output. Palaging isang blangkong string para sa mga repair-printability task.
- Name
  3mf
  Type
  string
  Description
  Nakalaan para sa 3MF output. Palaging isang blangkong string para sa mga repair-printability task.
- Name
  mtl
  Type
  string
  Description
  Nakalaan para sa MTL output. Palaging isang blangkong string para sa mga repair-printability task.
Name
thumbnail_url
Type
string
Description
URL ng preview image na na-render mula sa naayos na model.
Name
alpha_thumbnail_url
Type
string
Description
Downloadable URL patungo sa isang bersyon na may transparent background (RGBA) ng thumbnail_url. Naroroon lamang kapag nilikha ang task gamit ang alpha_thumbnail: true at matagumpay na na-render ang transparent na preview; kung hindi, inaalis ang field na ito.
Name
texture_urls
Type
array
Description
Palaging isang blangkong array. Pinapanatili lamang ng repair ang heometriya ng input at hindi muling nagba-bake ng mga texture.
Name
consumed_credits
Type
integer
Description
Ang bilang ng credits na ginamit ng task na ito. 10 kapag umabot na ang task sa SUCCEEDED. Nagbabalik ng 0 para sa mga FAILED na task (ang credits ay ire-refund kapag nabigo).
Name
intended_print
Type
object
Description
Ang printer at sukat na ginamit ng repair, ipinadala man o muling ginamit mula sa isang analyze task. Naroroon sa isang wall-thickness repair mula sa simula (PENDING); ang mga value na hindi pa alam ay null.
- Name
  printer_type
  Type
  string
  Description
  fdm, sla, o full_color.
- Name
  height_mm
  Type
  number
  Description
  Ang taas ng print sa millimeters, kung ang print ay sinukat ayon sa taas. Kung hindi, null.
- Name
  longest_side_mm
  Type
  number
  Description
  Ang pinakamahabang gilid ng print sa millimeters. Kapag sinukat ayon sa taas, kinakalkula ito mula sa mga proporsyon ng model, at ito ay null hanggang masukat ang model.
- Name
  wall_thickness_mm
  Type
  number
  Description
  Ang pinakamababang kapal ng dingding para sa printer_type, sa millimeters.
- Name
  dimensions_mm
  Type
  array
  Description
  Ang [width, depth, height] ng print sa millimeters. Ang taas ay maaaring magkaiba sa height_mm ng isang fraction ng millimeter. null hanggang magtagumpay ang task, at palaging null para sa input na hindi GLB.
Name
print_repair_report
Type
object
Description
Ang ginawa ng wall-thickness repair. Naroroon kapag matagumpay na ang isang wall-thickness repair.
- Name
  route
  Type
  string
  Description
  Kung aling repair ang tumakbo. Isa sa:
  
  thin_wall: mahigit 5% ng ibabaw ang masyadong manipis, kaya tumakbo rin ang wall thickening (tingnan ang applied).
  
  topology: sapat na kapal ang mga dingding; ang topology repair lamang ang tumakbo.
  
  topology_unmeasured: hindi nasukat ang mga dingding; ang topology repair lamang ang tumakbo.
- Name
  applied
  Type
  boolean
  Description
  Kung binago ng wall thickening ang mesh. Naroroon lamang kapag ang route ay thin_wall.
- Name
  faces_before
  Type
  integer
  Description
  Bilang ng mga face ng input mesh. Naroroon lamang kapag ang route ay thin_wall.
- Name
  faces_after
  Type
  integer
  Description
  Bilang ng mga face ng naayos na mesh. Naroroon lamang kapag ang route ay thin_wall.
- Name
  thin_area_ratio_before
  Type
  number
  Description
  Bahagi ng ibabaw ng input, mula 0 hanggang 1, na mas manipis kaysa sa intended_print.wall_thickness_mm. Inaalis kung hindi masukat ang input.
- Name
  thin_area_ratio_after
  Type
  number
  Description
  Ang parehong bahagi, sinukat sa naayos na model. Inaalis kung hindi ito masukat; matagumpay pa rin ang task.

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