lowpoly akan dihentikan pada 30 Okt 2026. Tukar model sebelum tarikh-tarikh ini untuk mengelakkan ralat permintaan. Lihat semua penamatan

API Baiki kebolehcetakan

Baiki model 3D supaya ia sedia untuk dicetak. Meshy membaiki tepi non-manifold, muka degenerat, lubang, dan isu topology lain. Anda juga boleh menebalkan dinding yang terlalu nipis pada saiz yang anda rancang untuk mencetak.

POST/openapi/v1/print/repair

Cipta tugas Baiki kebolehcetakan

Mencipta tugas Baiki kebolehcetakan, yang membaiki topology model 3D dan mengembalikan versi kalis air yang sedia untuk dicetak. Tugas ini berjalan di latar belakang. Untuk tempoh biasa tugas ini mengambil masa, lihat Masa pemprosesan.

Model yang dibaiki mempunyai format yang sama seperti input. Contohnya, untuk fail .stl dalam model_url, model_urls.stl menyimpan jejaring yang dibaiki, dan model_urls tidak mempunyai kekunci format lain. Dengan input_task_id, Meshy sentiasa membaiki fail GLB daripada tugas sumber, jadi output adalah fail .glb.

Meshy mengeluarkan tekstur model semasa pembaikan, kerana geometri berubah. Untuk menambah semula tekstur, hantar model yang dibaiki ke API Retekstur.

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

Parameter

  • Name
    input_task_id
    Type
    string
    Diperlukan
    Description

    Diperlukan kecuali anda menghantar model_url. ID tugas yang modelnya ingin anda baiki, contohnya tugas Imej ke 3D, Berbilang Imej ke 3D, Teks ke 3D, Remesh, Retekstur, atau Analisis kebolehcetakan. Tugas itu mestilah yang anda cipta dengan API, dengan status SUCCEEDED dan model GLB.

    Tugas Analisis kebolehcetakan yang memeriksa ketebalan dinding turut menyalurkan pencetak dan saiznya. Pembaikan kemudian memeriksa ketebalan dinding dan menebalkan dinding yang nipis, walaupun anda tidak menghantar kedua-duanya. printer_type atau saiz cetakan yang anda hantar akan menggantikan yang daripada analisis. Tugas Analisis kebolehcetakan bagi fail .stl, .fbx, atau .gltf daripada model_url tidak berfungsi. Hantar fail tersebut sebagai model_url sebaliknya.

  • Name
    model_url
    Type
    string
    Diperlukan
    Description

    Diperlukan kecuali anda menghantar input_task_id. Model untuk dibaiki, sebagai URL awam atau Data URI. Jika anda menghantar kedua-duanya, Meshy menggunakan input_task_id.

    Daripada URL http atau https, model mestilah fail .glb, .gltf, .obj, .fbx, atau .stl yang bersaiz maksimum 400 MB. Data URI hanya boleh menyimpan fail GLB base64 (data:model/gltf-binary;base64,...) atau glTF (data:model/gltf+json;base64,...) yang bersaiz maksimum 100 MB. Hantar fail .obj, .fbx, atau .stl sebagai URL http atau https.

    Fail yang melebihi 100 MB juga mesti mematuhi peraturan ini:

    • Fail GLB, glTF, FBX, atau OBJ boleh mempunyai maksimum 10,000,000 muka. Meshy mengira muka sebagai segi tiga, jadi segi empat dikira sebagai 2, dan jejaring yang dilukis lebih daripada sekali dikira sekali bagi setiap salinan.
    • Fail FBX mestilah FBX binari 7.1 atau lebih baharu.
    • Fail GLB atau glTF tidak boleh menggunakan mampatan Draco.

    URL muat turun Meshy (assets.meshy.ai/…?Expires=…&Signature=…) ditandatangani dan berhenti berfungsi pada expires_at tugasnya. Membaca tugas semula tidak memperbaharuinya. Untuk model yang anda hasilkan dengan Meshy, hantar input_task_id sebaliknya, yang berfungsi selagi Meshy mengekalkan tugas sumber (lihat Pengekalan aset). Untuk menggunakan model selepas itu, muat turun sebelum expires_at dan hantar salinan anda sendiri.

  • Name
    alpha_thumbnail
    Type
    boolean
    lalai false
    Description

    Sama ada untuk turut membuat pratonton dengan latar belakang lutsinar (RGBA), dikembalikan dalam alpha_thumbnail_url apabila anda mendapatkan tugas. thumbnail_url tidak berubah.

Untuk turut menebalkan dinding yang terlalu nipis pada saiz yang anda rancang untuk dicetak, hantar printer_type, saiz cetakan, atau kedua-duanya. Meshy menebalkan dinding hanya apabila lebih daripada 5% permukaan terlalu nipis untuk pencetak tersebut. Model yang dibaiki mengekalkan skala asalnya. Untuk mengubah skalanya, gunakan API Ubah saiz, yang menggunakan saiz dalam meter, jadi 100 mm ialah 0.1.

  • Name
    printer_type
    Type
    string
    Description

    Pencetak yang anda rancang untuk digunakan. Ia menetapkan ketebalan dinding minimum yang disasarkan oleh pembaikan. Jika anda menghantar saiz cetakan tanpa printer_type, Meshy menggunakan fdm, kecuali tugas Analisis kebolehcetakan dalam input_task_id membekalkan 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

    Sebarang nilai lain mengembalikan 400.

  • Name
    intended_print_height_mm
    Type
    number
    Description

    Ketinggian cetakan, dalam milimeter, dari 1 hingga 1000. Nilai di luar julat ini mengembalikan 400. Hantar ini atau intended_print_longest_side_mm, bukan kedua-duanya.

    Ia hanya berfungsi dengan input GLB. Untuk model_url yang bukan fail .glb, hantar intended_print_longest_side_mm sebaliknya.

  • Name
    intended_print_longest_side_mm
    Type
    number
    Description

    Panjang sisi terpanjang cetakan, dalam milimeter, dari 1 hingga 1000. Nilai di luar julat ini mengembalikan 400. Ia berfungsi dengan setiap format input.

Jika anda menghantar printer_type tanpa saiz, dan Meshy tidak menggunakan semula sebarang saiz daripada tugas Analisis kebolehcetakan, Meshy menggunakan saiz cetakan ini:

  • Fail .glb atau sebarang input_task_id: tinggi 150 mm
  • Fail .stl: sisi terpanjang fail itu sendiri, dibaca sebagai milimeter
  • Fail .obj, .fbx, atau .gltf: 150 mm pada sisi terpanjang

Untuk fail STL dalam unit lain, hantar intended_print_longest_side_mm.

Meshy membundarkan kedua-dua saiz cetakan kepada milimeter terdekat.

Pulangan

Medan result dalam respons menyimpan ID tugas Baiki kebolehcetakan yang baharu.

Mod kegagalan

  • Name
    400 - Bad Request
    Description

    Permintaan tidak dapat dijalankan. Mesej ralat menyatakan masalah yang ditemui. Contohnya:

    • Parameter hilang: Sama ada input_task_id mahupun model_url tidak dihantar.
    • UUID tidak sah: input_task_id bukan UUID yang sah.
    • URL model tidak sah: model_url cacat, menggunakan skema yang tidak disokong, atau mempunyai sambungan fail yang tidak disokong.
    • Fail model terlalu besar: Fail model_url melebihi 400 MB daripada URL http atau https, atau melebihi 100 MB sebagai Data URI.
    • Terlalu banyak muka: Fail model_url adalah fail GLB, glTF, FBX, atau OBJ melebihi 100 MB dengan lebih daripada 10,000,000 muka. Kurangkan bilangan muka, kemudian hantar fail itu semula.
    • ASCII FBX melebihi 100 MB: Fail model_url ialah ASCII FBX melebihi 100 MB. Hantar sebagai FBX binari atau GLB.
    • Fail model tidak boleh dibaca: Fail model_url melebihi 100 MB, dan Meshy tidak dapat membaca headernya. Contohnya, ia adalah GLB atau glTF yang dimampatkan Draco, atau FBX binari lebih lama daripada 7.1.
    • Header model terlalu kompleks: Fail model_url melebihi 100 MB, dan headernya mempunyai terlalu banyak jejaring, nod, atau rekod untuk diperiksa. Kurangkan bilangan objek dalam fail, kemudian hantar semula.
    • Fail model tidak dapat dimuat turun: model_url mengembalikan ralat, paling kerap kerana URL muat turun Meshy yang ditandatangani telah tamat tempoh. Membaca tugas semula mengembalikan URL yang sama dengan tempoh tamat yang sama. Hantar salinan fail anda sendiri, atau hantar input_task_id selagi Meshy mengekalkan tugas sumber.
    • Tugas belum berjaya: Tugas input_task_id masih dalam keadaan tertangguh, sedang berjalan, atau gagal.
    • GLB hilang: Tugas input_task_id tidak mempunyai model GLB untuk dibaiki.
    • Saiz cetakan tidak sah: intended_print_height_mm atau intended_print_longest_side_mm berada di luar 1 hingga 1000, atau permintaan mempunyai kedua-duanya.
    • Jenis pencetak tidak diketahui: printer_type bukan fdm, sla, atau full_color.
    • Ketinggian pada model bukan GLB: Permintaan mempunyai intended_print_height_mm dan model_url yang bukan fail .glb. Hantar intended_print_longest_side_mm sebaliknya.
    • Tidak dapat menetapkan saiz model ini mengikut ketinggian: Pada ketinggian yang diminta, atau lalai 150 mm, sisi terpanjang model akan berada di luar 1 hingga 1,000 mm. Ia juga berlaku apabila model itu rata, atau apabila Meshy tidak dapat menentukan saiznya. Hantar intended_print_longest_side_mm sebaliknya. Untuk model_url .glb dan sesetengah tugas input_task_id, Meshy hanya mendapati ini selepas tugas bermula, dan tugas berakhir sebagai FAILED sebaliknya.
    • Saiz STL tidak boleh digunakan: Permintaan mempunyai printer_type tanpa saiz, dan Meshy tidak dapat membaca sisi terpanjang fail .stl itu sendiri, atau ia berada di luar 1 hingga 1,000 mm. Hantar intended_print_longest_side_mm.

    Betulkan permintaan, kemudian hantar semula. Lihat Ralat.

  • Name
    401 - Unauthorized
    Description

    Kunci API tiada atau tidak sah. Semak header Authorization.

  • Name
    402 - Payment Required
    Description

    Contohnya:

    • Kredit tidak mencukupi: Akaun tidak mempunyai kredit yang cukup untuk tugas ini, atau akaun telah mencapai had kredit. Semak baki kredit anda, kemudian cuba semula.
    • Pelan percuma: Mencipta tugas memerlukan pelan berbayar. Naik taraf pelan anda dalam tetapan langganan anda, kemudian cuba semula.
  • Name
    403 - Forbidden
    Description

    input_task_id adalah model bas-relief, yang tidak dapat dibaiki oleh endpoint ini. Mesejnya ialah This model type does not support this operation. Hantar model yang berbeza.

  • Name
    404 - Not Found
    Description

    Tugas input_task_id tidak wujud atau dimiliki oleh pengguna lain. Semak ID, dan gunakan kunci API daripada akaun yang mencipta tugas itu.

  • Name
    429 - Too Many Requests
    Description

    Anda melebihi had kadar anda, atau anda mempunyai terlalu banyak tugas yang tertangguh. Tunggu, kemudian cuba semula. Lihat Had kadar.

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

Dapatkan tugas Baiki kebolehcetakan

Mengembalikan tugas Baiki kebolehcetakan mengikut IDnya.

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

Parameter

  • Name
    id
    Type
    path
    Description

    ID tugas daripada respons penciptaan.

Nilai yang Dikembalikan

Objek tugas Baiki kebolehcetakan. Medan model_urls-nya kosong sehingga tugas berstatus SUCCEEDED. Selepas itu, ia hanya mempunyai kunci yang sepadan dengan format input. Baiki ketebalan dinding menyertakan intended_print sejak permulaan, dan print_repair_report selepas tugas berjaya.

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

Padam tugas Baiki kebolehcetakan

Memadam secara kekal tugas Baiki kebolehcetakan, termasuk model yang telah dibaiki. Anda tidak boleh membatalkan tindakan padam ini.

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

Parameter laluan

  • Name
    id
    Type
    path
    Description

    ID tugas yang hendak dipadam.

Status tugas

Memadam tugas PENDING akan memulangkan semula kredit yang digunakan semasa anda mencipta tugas tersebut.

Tugas IN_PROGRESS tidak boleh dipadam. Permintaan akan memulangkan 409 Conflict, dan tugas tersebut terus berjalan. Meshy tidak memulangkan semula kredit untuk tugas yang telah dimulakan, jadi memadamnya akan menyebabkan anda kehilangan kedua-dua kredit dan hasilnya. Tunggu sehingga ia mencapai status SUCCEEDED, FAILED, atau CANCELED, kemudian padamkannya.

Memadam tugas yang berada dalam status akhir (SUCCEEDED, FAILED, atau CANCELED) tidak akan memulangkan semula kreditnya.

Pulangan

200 OK apabila tugas berjaya dipadam, atau 409 Conflict apabila tugas berstatus IN_PROGRESS.

GET/openapi/v1/print/repair

Senaraikan tugas Baiki kebolehcetakan

Mengembalikan senarai tugas Baiki kebolehcetakan anda.

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

Parameter

  • Name
    page_num
    Type
    integer
    lalai 1
    Description

    Nombor halaman yang hendak dikembalikan, bermula pada 1.

  • Name
    page_size
    Type
    integer
    lalai 10
    Description

    Bilangan tugas setiap halaman, sehingga 100.

  • Name
    sort_by
    Type
    string
    Description

    Susunan isihan.

    Nilai yang tersedia:

    • +created_at: paling lama dahulu
    • -created_at: paling baharu dahulu

Hasil

Senarai bersaiz halaman bagi objek tugas Baiki kebolehcetakan.

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

Strim tugas Baiki kebolehcetakan

Menstrim kemas kini tugas Baiki kebolehcetakan sebagai 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
}

Parameter

  • Name
    id
    Type
    path
    Description

    ID tugas daripada respons create.

Pulangan

Strim objek tugas Baiki kebolehcetakan sebagai Server-Sent Events.

Setiap peristiwa (event) memegang objek tugas yang lengkap, dalam bentuk yang sama seperti yang dikembalikan oleh endpoint Get. Semasa tugas masih PENDING atau IN_PROGRESS, medan outputnya kosong (null, [], atau {}), dan finished_at adalah 0. model_urls adalah objek kosong sehingga tugas itu SUCCEEDED.

Objek tugas Repair Printability

Objek tugas Repair Printability menerangkan satu pembaikan model 3D. Ia menyimpan status, progress, dan model yang dibaiki apabila tugas 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=***"
  },
  "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

    ID tugas. Anggap ia sebagai string legap, dan jangan bergantung pada formatnya.

  • Name
    type
    Type
    string
    Description

    Jenis tugas, sentiasa print-repair.

  • Name
    status
    Type
    string
    Description

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

  • Name
    progress
    Type
    integer
    Description

    Berapa banyak tugas telah selesai, dalam peratusan. Ia adalah 0 sehingga tugas bermula dan 100 apabila ia berjaya.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Bilangan tugas yang mendahului tugas ini dalam baris gilir. Nilai ini hanya bermakna semasa tugas berstatus PENDING.

  • Name
    created_at
    Type
    timestamp
    Description

    Masa tugas dicipta, dalam milisaat Unix.

  • Name
    started_at
    Type
    timestamp
    Description

    Masa tugas bermula, dalam milisaat Unix. Ia adalah 0 sehingga tugas bermula.

  • Name
    finished_at
    Type
    timestamp
    Description

    Masa tugas selesai, dalam milisaat Unix. Ia adalah 0 sehingga tugas selesai.

  • Name
    expires_at
    Type
    timestamp
    Description

    Masa hasil tugas tamat tempoh, dalam milisaat Unix. Ia adalah 0 sehingga tugas selesai.

  • Name
    task_error
    Type
    object
    Description

    Butiran ralat apabila tugas gagal. Ia adalah null jika tugas tidak gagal. Lihat Ralat.

    • Name
      message
      Type
      string
      Description

      Penerangan tentang perkara yang tidak kena.

  • Name
    model_urls
    Type
    object
    Description

    URL muat turun untuk model yang dibaiki. Ia hanya mempunyai kunci yang sepadan dengan format input. Format yang tidak dijana oleh tugas tidak mempunyai kunci, bukannya string kosong.

    • Name
      glb
      Type
      string
      Description

      Fail GLB yang dibaiki. Ditetapkan apabila input adalah fail GLB atau anda menghantar input_task_id.

    • Name
      gltf
      Type
      string
      Description

      Fail glTF yang dibaiki. Ditetapkan apabila input adalah fail glTF.

    • Name
      fbx
      Type
      string
      Description

      Fail FBX yang dibaiki. Ditetapkan apabila input adalah fail FBX.

    • Name
      obj
      Type
      string
      Description

      Fail OBJ yang dibaiki. Ditetapkan apabila input adalah fail OBJ.

    • Name
      stl
      Type
      string
      Description

      Fail STL yang dibaiki. Ditetapkan apabila input adalah fail STL.

  • Name
    thumbnail_url
    Type
    string
    Description

    URL muat turun untuk imej pratonton model yang dibaiki.

  • Name
    alpha_thumbnail_url
    Type
    string
    Description

    URL muat turun untuk versi thumbnail_url dengan latar belakang lutsinar (RGBA). Hadir hanya apabila anda mencipta tugas dengan alpha_thumbnail: true dan Meshy merender pratonton lutsinar tersebut.

  • Name
    texture_urls
    Type
    array
    Description

    Sentiasa tatasusunan kosong. Repair hanya mengekalkan geometri input dan tidak membakar semula texture.

  • Name
    consumed_credits
    Type
    integer
    Description

    Bilangan kredit yang digunakan oleh tugas. Ia adalah 10 apabila tugas berstatus SUCCEEDED, dan 0 untuk tugas FAILED, kerana Meshy memulangkan kredit apabila tugas gagal.

  • Name
    intended_print
    Type
    object
    Description

    Pencetak dan saiz yang digunakan oleh pembaikan, sama ada anda menghantarnya atau Meshy menggunakannya semula daripada tugas Analyze Printability. Hadir pada pembaikan ketebalan dinding sejak awal, termasuk semasa tugas berstatus PENDING. Nilai yang belum diketahui oleh Meshy adalah null.

    • Name
      printer_type
      Type
      string
      Description

      Jenis pencetak, fdm, sla, atau full_color.

    • Name
      height_mm
      Type
      number
      Description

      Ketinggian cetakan, dalam milimeter, apabila cetakan disaizkan mengikut ketinggian. Jika tidak, ia adalah null.

    • Name
      longest_side_mm
      Type
      number
      Description

      Panjang sisi terpanjang cetakan, dalam milimeter. Apabila cetakan disaizkan mengikut ketinggian, Meshy mengiranya daripada nisbah model, dan ia adalah null sehingga Meshy mengukur model tersebut.

    • Name
      wall_thickness_mm
      Type
      number
      Description

      Ketebalan dinding minimum untuk printer_type, dalam milimeter.

    • Name
      dimensions_mm
      Type
      array
      Description

      [width, depth, height] cetakan, dalam milimeter. Ketinggian boleh berbeza daripada height_mm sebanyak pecahan milimeter. Ia adalah null sehingga tugas berjaya, dan sentiasa null untuk input selain GLB.

  • Name
    print_repair_report
    Type
    object
    Description

    Apa yang dilakukan oleh pembaikan ketebalan dinding. Hadir selepas 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. Untuk melihat sama ada ia mengubah jejaring, semak applied.
      • topology: dinding sudah cukup tebal, jadi hanya pembaikan topology dijalankan.
      • topology_unmeasured: Meshy tidak dapat mengukur dinding, jadi hanya pembaikan topology dijalankan.
    • Name
      applied
      Type
      boolean
      Description

      Sama ada penebalan dinding mengubah jejaring. Hadir hanya apabila route adalah thin_wall.

    • Name
      faces_before
      Type
      integer
      Description

      Bilangan muka jejaring input. Hadir hanya apabila route adalah thin_wall.

    • Name
      faces_after
      Type
      integer
      Description

      Bilangan muka jejaring yang dibaiki. Hadir hanya apabila route adalah thin_wall.

    • Name
      thin_area_ratio_before
      Type
      number
      Description

      Bahagian permukaan input yang lebih nipis daripada intended_print.wall_thickness_mm, daripada 0 hingga 1. Ditinggalkan apabila Meshy tidak dapat mengukur input.

    • Name
      thin_area_ratio_after
      Type
      number
      Description

      Bahagian yang sama, diukur pada model yang dibaiki. Ditinggalkan apabila Meshy tidak dapat mengukurnya. Tugas tetap berjaya.