Repair Printability API

Ayusin ang isang 3D na modelo upang ito ay handa nang i-print. Inaayos ng Meshy ang mga non-manifold edges, degenerate faces, butas, at iba pang isyu sa topology. Maaari mo ring gawing mas makapal ang mga pader na masyadong manipis sa sukat na balak mong i-print.

POST/openapi/v1/print/repair

Gumawa ng Repair Printability task

Gumagawa ng Repair Printability task, na nagkukumpuni sa topology ng isang 3D model at nagbabalik ng watertight na bersyon na handa nang i-print. Tumatakbo ang task sa background. Para sa karaniwang tagal ng isang task, tingnan ang Processing times.

Ang nakumpunihang modelo ay may parehong format ng input. Halimbawa, para sa isang .stl file sa model_url, ang model_urls.stl ang naghahawak ng nakumpunihang mesh, at wala nang ibang format keys ang model_urls. Gamit ang input_task_id, palaging kinukumpuni ng Meshy ang GLB file ng source task, kaya ang output ay isang .glb file.

Tinatanggal ng Meshy ang mga texture ng modelo habang kinukumpuni ito, dahil nagbabago ang heometriya. Para maibalik ang mga texture, ipadala ang nakumpunihang modelo sa Retexture API.

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

Mga Parameter

Name
input_task_id
Type
string
Kinakailangan
Description
Kinakailangan maliban kung magpapadala ka ng model_url. Ang ID ng task na ang modelo ay gusto mong kumpunihin, halimbawa isang Image to 3D, Multi-Image to 3D, Text to 3D, Remesh, Retexture, o Analyze Printability task. Dapat ang task ay isang ginawa mo gamit ang API, na may status na SUCCEEDED at mayroong GLB model.
Ang Analyze Printability task na nag-check ng kapal ng dingding ay ipinapasa rin ang printer at sukat nito. Che-check rin ng repair ang kapal ng dingding at papalapatin ang manipis na mga dingding, kahit wala kang ipinadala sa dalawa. Ang isang printer_type o sukat ng print na ipinadala mo ay papalitan ang galing sa analysis. Ang isang Analyze Printability task ng .stl, .fbx, o .gltf file mula sa model_url ay hindi gagana. Ipadala na lang ang file na iyon bilang model_url.

Name
model_url
Type
string
Kinakailangan
Description
Kinakailangan maliban kung magpapadala ka ng input_task_id. Ang modelong kukumpunihin, bilang isang public URL o isang data URI. Kung ipadala mo pareho, gagamitin ng Meshy ang input_task_id.
Mula sa isang http o https URL, dapat ang modelo ay isang .glb, .gltf, .obj, .fbx, o .stl file na hanggang 400 MB lamang. Ang isang data URI ay maaari lamang maghawak ng base64 GLB (data:model/gltf-binary;base64,...) o glTF (data:model/gltf+json;base64,...) file na hanggang 100 MB lamang. Ipadala ang .obj, .fbx, o .stl file bilang isang http o https URL.
Ang file na higit sa 100 MB ay dapat ding sumunod sa mga patakarang ito:
- Ang GLB, glTF, FBX, o OBJ file ay maaaring magkaroon ng hanggang 10,000,000 faces. Binibilang ng Meshy ang faces bilang mga triangle, kaya ang isang quad ay binibilang bilang 2, at ang isang mesh na iginuhit nang higit sa isang beses ay binibilang nang isang beses bawat kopya.
- Ang FBX file ay dapat binary FBX 7.1 o mas bago.
- Ang GLB o glTF file ay hindi dapat gumamit ng Draco compression.
Ang isang Meshy download URL (assets.meshy.ai/…?Expires=…&Signature=…) ay naka-sign at titigil sa paggana sa expires_at ng task nito. Hindi ito na-renew sa muling pagbasa ng task. Para sa isang modelong ginawa mo gamit ang Meshy, ipadala na lang ang input_task_id, na gagana habang pinapanatili ng Meshy ang source task (tingnan ang Asset retention). Para magamit ang modelo pagkatapos niyon, i-download ito bago ang expires_at at magpadala ng sarili mong kopya.

Name
alpha_thumbnail
Type
boolean
default false
Description
Kung magre-render din ng preview na may transparent na background (RGBA), ibinabalik sa alpha_thumbnail_url kapag kinuha mo ang task. Hindi nagbabago ang thumbnail_url.

Para papalapatin din ang mga dingding na masyadong manipis sa sukat na balak mong i-print, magpadala ng printer_type, isang sukat ng print, o pareho. Papalapatin ng Meshy ang mga dingding lamang kapag higit sa 5% ng ibabaw ay masyadong manipis para sa printer na iyon. Pinananatili ng nakumpunihang modelo ang orihinal nitong scale. Para i-scale ito, gamitin ang Resize API, na tumatanggap ng mga sukat sa metro, kaya ang 100 mm ay 0.1.

Name
printer_type
Type
string
Description
Ang printer na balak mong gamitin. Itinatakda nito ang minimum na kapal ng dingding na tinatarget ng repair. Kung magpapadala ka ng sukat ng print nang wala ang printer_type, gagamitin ng Meshy ang fdm, maliban kung ang isang Analyze Printability task sa input_task_id ay nagbibigay ng printer.
Mga available na value:
- 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
Ang anumang ibang value ay magbabalik ng 400.
Name
intended_print_height_mm
Type
number
Description
Ang taas ng print, sa millimeters, mula 1 hanggang 1000. Ang value na wala sa range ay magbabalik ng 400. Ipadala ito o ang intended_print_longest_side_mm, hindi pareho.
Gumagana lamang ito sa GLB input. Para sa isang model_url na hindi .glb file, ipadala na lang ang intended_print_longest_side_mm.
Name
intended_print_longest_side_mm
Type
number
Description
Ang haba ng pinakamahabang bahagi ng print, sa millimeters, mula 1 hanggang 1000. Ang value na wala sa range ay magbabalik ng 400. Gumagana ito sa bawat input format.

Kung magpapadala ka ng printer_type nang walang sukat, at walang sukat na muling ginamit ng Meshy mula sa isang Analyze Printability task, gagamitin ng Meshy ang sukat ng print na ito:

.glb file o anumang input_task_id: 150 mm ang taas
.stl file: ang sariling pinakamahabang bahagi ng file, binabasa bilang millimeters
.obj, .fbx, o .gltf file: 150 mm sa pinakamahabang bahagi

Para sa isang STL file sa ibang units, ipadala ang intended_print_longest_side_mm.

Binabaligtad ng Meshy ang parehong sukat ng print sa pinakamalapit na millimeter.

Mga Ibinabalik

Ang result field ng response ay naghahawak ng ID ng bagong Repair Printability task.

Mga paraan ng pagkabigo

Name
400 - Bad Request
Description
Hindi matatakbo ang request. Sinasabi ng error message kung aling problema ang natagpuan nito. Halimbawa:
- Missing parameter: Walang ipinadalang input_task_id ni model_url.
- Invalid UUID: Hindi valid na UUID ang input_task_id.
- Invalid model URL: Mali ang pagkakabuo ng model_url, gumagamit ito ng hindi suportadong scheme, o may hindi suportadong file extension.
- Model file too large: Ang model_url file ay higit sa 400 MB mula sa isang http o https URL, o higit sa 100 MB bilang isang data URI.
- Too many faces: Ang model_url file ay isang GLB, glTF, FBX, o OBJ file na higit sa 100 MB na may higit sa 10,000,000 faces. Bawasan ang bilang ng faces, pagkatapos ay ipadala ulit ang file.
- ASCII FBX over 100 MB: Ang model_url file ay isang ASCII FBX na higit sa 100 MB. Ipadala ito bilang binary FBX o GLB.
- Unreadable model file: Ang model_url file ay higit sa 100 MB, at hindi mabasa ng Meshy ang header nito. Halimbawa, ito ay isang Draco-compressed na GLB o glTF, o isang binary FBX na mas luma kaysa 7.1.
- Model header too complex: Ang model_url file ay higit sa 100 MB, at ang header nito ay may napakaraming mesh, node, o record na dapat i-check. Bawasan ang bilang ng mga object sa file, pagkatapos ay ipadala ito ulit.
- Model file can't be downloaded: Nagbalik ng error ang model_url, kadalasan dahil nag-expire na ang isang naka-sign na Meshy download URL. Ang muling pagbasa sa task ay nagbabalik ng parehong URL na may parehong expiry. Magpadala ng sarili mong kopya ng file, o ipadala ang input_task_id habang pinapanatili ng Meshy ang source task.
- Task not succeeded: Ang input_task_id task ay nasa pending pa, in progress, o nabigo.
- Missing GLB: Ang input_task_id task ay walang GLB model na kukumpunihin.
- Invalid print size: Ang intended_print_height_mm o intended_print_longest_side_mm ay wala sa 1 hanggang 1000, o ang request ay may pareho.
- Unknown printer type: Ang printer_type ay hindi fdm, sla, o full_color.
- Height on a non-GLB model: May intended_print_height_mm ang request at isang model_url na hindi .glb file. Ipadala na lang ang intended_print_longest_side_mm.
- Can't size this model by height: Sa hiniling na taas, o sa default na 150 mm, ang pinakamahabang bahagi ng modelo ay wala sa 1 hanggang 1,000 mm. Nangyayari rin ito kapag patag ang modelo, o kapag hindi matukoy ng Meshy ang sukat nito. Ipadala na lang ang intended_print_longest_side_mm. Para sa isang .glb na model_url at ilang input_task_id task, natutuklasan lamang ito ng Meshy pagkatapos magsimula ang task, at natatapos ang task bilang FAILED sa halip.
- STL size unusable: May printer_type ang request nang walang sukat, at hindi mabasa ng Meshy ang sariling pinakamahabang bahagi ng .stl file, o wala ito sa 1 hanggang 1,000 mm. Ipadala ang intended_print_longest_side_mm.
Ayusin ang request, pagkatapos ay ipadala ito ulit. Tingnan ang Errors.
Name
401 - Unauthorized
Description
Nawawala o invalid ang API key. Suriin ang Authorization header.
Name
402 - Payment Required
Description
Halimbawa:
- Insufficient credits: Ang account ay walang sapat na credits para sa task na ito, o naabot na ng account ang limitasyon ng credit. Suriin ang iyong balanse ng credit, pagkatapos ay subukan ulit.
- Free plan: Ang paggawa ng task ay nangangailangan ng bayad na plano. I-upgrade ang iyong plano sa iyong mga setting ng subscription, pagkatapos ay subukan ulit.
Name
403 - Forbidden
Description
Ang input_task_id ay isang bas-relief model, na hindi makukumpuni ng endpoint na ito. Ang mensahe ay This model type does not support this operation. Magpadala ng ibang modelo.
Name
404 - Not Found
Description
Ang input_task_id task ay hindi umiiral o pag-aari ng ibang user. Suriin ang ID, at gumamit ng API key mula sa account na gumawa ng task.
Name
429 - Too Many Requests
Description
Nalagpasan mo ang iyong rate limit, o may masyado kang maraming pending na task. Maghintay, pagkatapos ay subukan ulit. Tingnan ang Rate limits.

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

Kumuha ng Repair Printability task

Nagbabalik ng Repair Printability task batay sa ID nito.

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": {
    "stl": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.stl?Expires=***"
  },
  "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=***"
  },
  "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
  }
}

Mga Parameter

Name
id
Type
path
Description
Ang task ID mula sa create response.

Ibinabalik

Ang Repair Printability task object. Walang laman ang field na model_urls nito hanggang sa maging SUCCEEDED ang task. Pagkatapos noon, mayroon na lamang itong key na tumutugma sa input format. Ang wall-thickness repair ay may kasamang intended_print mula sa simula pa lamang, at print_repair_report pagkatapos magtagumpay ang task.

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

Mag-delete ng Repair Printability task

Permanenteng nagde-delete ng isang Repair Printability task, kasama na ang nai-repair nitong modelo. Hindi mo na puwedeng i-undo ang pag-delete.

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

Mga path parameter

Name
id
Type
path
Description
Ang ID ng task na ide-delete.

Status ng task

Ang pag-delete ng isang PENDING na task ay nagre-refund ng mga credits na ginamit nito noong ginawa mo ito.

Ang isang IN_PROGRESS na task ay hindi puwedeng i-delete. Ibabalik ng request ang 409 Conflict, at magpapatuloy ang pagtakbo ng task. Hindi nagre-refund si Meshy para sa isang task na nagsimula na, kaya kung ide-delete mo ito, mawawalan ka parehong ng credits at ng resulta. Hintayin na umabot ito sa SUCCEEDED, FAILED, o CANCELED, bago ito i-delete.

Ang pag-delete ng isang task na nasa final status na (SUCCEEDED, FAILED, o CANCELED) ay hindi nagre-refund ng mga credits nito.

Mga ibinabalik

200 OK kapag na-delete na ang task, o 409 Conflict kapag ang task ay IN_PROGRESS.

GET/openapi/v1/print/repair

Ilista ang mga Repair Printability na gawain

Nagbabalik ng listahan ng iyong mga Repair Printability na gawain.

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=***"
    },
    "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
    "texture_urls": [],
    "consumed_credits": 10
  }
]

Mga Parameter

Name
page_num
Type
integer
default 1
Description
Ang bilang ng pahina na ibabalik, nagsisimula sa 1.
Name
page_size
Type
integer
default 10
Description
Ang bilang ng mga gawain bawat pahina, hanggang 100.
Name
sort_by
Type
string
Description
Ang pagkakasunod-sunod ng pag-uuri.
Mga available na value:
- +created_at: pinakaluma muna
- -created_at: pinakabago muna

Mga Ibinabalik

Isang paginated na listahan ng Repair Printability task objects.

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

I-stream ang isang Repair Printability task

Nagsa-stream ng mga update ng isang Repair Printability task bilang Server-Sent Events (SSE).

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 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-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=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/a43b5c6d-7e8f-901a-234b-567c890d1e2f/output/preview.png?Expires=***",
  "texture_urls": [],
  "consumed_credits": 10
}

Mga Parameter

Name
id
Type
path
Description
Ang task ID mula sa create response.

Ibinabalik

Isang stream ng Repair Printability task objects bilang Server-Sent Events.

Ang bawat event ay naglalaman ng buong task object, sa parehong anyo na ibinabalik ng Get endpoint. Habang ang task ay PENDING o IN_PROGRESS, ang mga output field nito ay walang laman (null, [], o {}), at ang finished_at ay 0. Ang model_urls ay isang walang-laman na object hanggang ang task ay maging SUCCEEDED.

The Repair Printability task object

Ang Repair Printability task object ay naglalarawan ng isang repair ng isang 3D model. Naglalaman ito ng status, progress, at ng na-repair na model kapag nagtagumpay 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=***"
  },
  "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=***"
  },
  "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
  }
}

Name
id
Type
string
Description
Ang task ID. Ituring itong isang opaque na string, at huwag umasa sa format nito.
Name
type
Type
string
Description
Ang uri ng task, laging print-repair.
Name
status
Type
string
Description
Ang status ng task, isa sa PENDING, IN_PROGRESS, SUCCEEDED, FAILED, o CANCELED.
Name
progress
Type
integer
Description
Kung gaano karaming bahagi ng task ang nagawa na, bilang porsyento. Ito ay 0 hanggang magsimula ang task at 100 kapag nagtagumpay ito.
Name
preceding_tasks
Type
integer
Description
Ang bilang ng mga task na nauuna sa queue bago ang task na ito. Makabuluhan ang value na ito lamang habang PENDING ang task.
Name
created_at
Type
timestamp
Description
Oras nang likhain ang task, sa Unix milliseconds.
Name
started_at
Type
timestamp
Description
Oras nang magsimula ang task, sa Unix milliseconds. Ito ay 0 hanggang magsimula ang task.
Name
finished_at
Type
timestamp
Description
Oras nang matapos ang task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.
Name
expires_at
Type
timestamp
Description
Oras nang mag-expire ang resulta ng task, sa Unix milliseconds. Ito ay 0 hanggang matapos ang task.
Name
task_error
Type
object
Description
Ang detalye ng error kapag nabigo ang task. Ito ay null kung hindi nabigo ang task. Tingnan ang Errors.
- Name
  message
  Type
  string
  Description
  Isang paglalarawan ng nangyaring mali.
Name
model_urls
Type
object
Description
Mga download URL para sa na-repair na model. Mayroon lamang itong key na tumutugma sa input format. Ang isang format na hindi nilikha ng task ay walang key, sa halip na isang blangkong string.
- Name
  glb
  Type
  string
  Description
  Ang na-repair na GLB file. Nakatakda kapag ang input ay isang GLB file o ipinadala mo ang input_task_id.
- Name
  gltf
  Type
  string
  Description
  Ang na-repair na glTF file. Nakatakda kapag ang input ay isang glTF file.
- Name
  fbx
  Type
  string
  Description
  Ang na-repair na FBX file. Nakatakda kapag ang input ay isang FBX file.
- Name
  obj
  Type
  string
  Description
  Ang na-repair na OBJ file. Nakatakda kapag ang input ay isang OBJ file.
- Name
  stl
  Type
  string
  Description
  Ang na-repair na STL file. Nakatakda kapag ang input ay isang STL file.
Name
thumbnail_url
Type
string
Description
Download URL para sa isang preview image ng na-repair na model.
Name
alpha_thumbnail_url
Type
string
Description
Download URL para sa isang bersyon ng thumbnail_url na may transparent na background (RGBA). Naroroon lamang kapag nilikha mo ang task gamit ang alpha_thumbnail: true at na-render ni Meshy ang transparent na preview.
Name
texture_urls
Type
array
Description
Laging isang blangkong array. Ang Repair ay pinapanatili lamang ang input heometriya at hindi muling bina-bake ang mga texture.
Name
consumed_credits
Type
integer
Description
Ang bilang ng credits na ginamit ng task. Ito ay 10 kapag ang task ay SUCCEEDED, at 0 para sa isang FAILED na task, dahil ibinabalik ni Meshy ang credits kapag nabigo ang isang task.
Name
intended_print
Type
object
Description
Ang printer at sukat na ginamit ng repair, kung ipinadala mo ang mga ito o muling ginamit ni Meshy ang mga ito mula sa isang Analyze Printability task. Naroroon sa isang wall-thickness repair mula sa simula pa lang, kabilang habang ang task ay PENDING. Ang isang value na hindi pa alam ni Meshy ay null.
- Name
  printer_type
  Type
  string
  Description
  Ang uri ng printer, fdm, sla, o full_color.
- Name
  height_mm
  Type
  number
  Description
  Ang taas ng print, sa millimeters, kapag ang print ay sinusukat ayon sa taas. Kung hindi, ito ay null.
- Name
  longest_side_mm
  Type
  number
  Description
  Ang haba ng pinakamahabang gilid ng print, sa millimeters. Kapag sinusukat ang print ayon sa taas, kinakalkula ito ni Meshy mula sa mga proporsyon ng model, at ito ay null hanggang sukatin ni Meshy 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 ilang bahagi ng isang millimeter. Ito ay null hanggang magtagumpay ang task, at laging null para sa input na hindi GLB.
Name
print_repair_report
Type
object
Description
Kung ano ang ginawa ng wall-thickness repair. Naroroon pagkatapos magtagumpay ang isang wall-thickness repair.
- Name
  route
  Type
  string
  Description
  Kung aling repair ang tumakbo, isa sa:
  
  thin_wall: higit sa 5% ng ibabaw ang masyadong manipis, kaya tumakbo rin ang pagpapakapal ng dingding. Upang malaman kung binago nito ang mesh, tingnan ang applied.
  
  topology: sapat na ang kapal ng mga dingding, kaya tanging ang topology repair lamang ang tumakbo.
  
  topology_unmeasured: hindi masukat ni Meshy ang mga dingding, kaya tanging ang topology repair lamang ang tumakbo.
- Name
  applied
  Type
  boolean
  Description
  Kung binago ng pagpapakapal ng dingding ang mesh. Naroroon lamang kapag ang route ay thin_wall.
- Name
  faces_before
  Type
  integer
  Description
  Ang bilang ng mga face ng input mesh. Naroroon lamang kapag ang route ay thin_wall.
- Name
  faces_after
  Type
  integer
  Description
  Ang bilang ng mga face ng na-repair na mesh. Naroroon lamang kapag ang route ay thin_wall.
- Name
  thin_area_ratio_before
  Type
  number
  Description
  Ang bahagi ng ibabaw ng input na mas manipis kaysa sa intended_print.wall_thickness_mm, mula 0 hanggang 1. Hindi isinasama kapag hindi masukat ni Meshy ang input.
- Name
  thin_area_ratio_after
  Type
  number
  Description
  Ang parehong bahagi, sinukat sa na-repair na model. Hindi isinasama kapag hindi ito masukat. Nagtatagumpay pa rin ang task.