Auto Split API

แยกโมเดล 3D ออกเป็นชิ้นส่วนที่พิมพ์แยกกันได้ — โดยอัตโนมัติ ตามชื่อชิ้นส่วนที่คุณกำหนด หรือตามพื้นที่สี — พร้อมตัวเชื่อมต่อ (connector) ที่เป็นตัวเลือกเสริม บริเวณที่บางลงจากการตัดจะได้รับการเสริมความแข็งแรงเสมอ เพื่อให้ทุกชิ้นส่วนพิมพ์ออกมาแบบทึบตัน

ขณะนี้ Auto Split รองรับเฉพาะโมเดลที่ ไม่มีพื้นผิว (untextured) เท่านั้น สำหรับ รูปภาพเป็น 3D และ หลายรูปเป็น 3D ให้สร้างข้อมูลนำเข้าโดยตั้งค่า should_texture เป็น false หากข้อมูลนำเข้ามีพื้นผิว (textured) ระบบจะปฏิเสธด้วยรหัส 400 การรองรับโมเดลที่มีพื้นผิวกำลังอยู่ระหว่างดำเนินการ (progress)

POST/openapi/v1/print/split

สร้างงาน Auto Split

เอนด์พอยต์นี้สร้างงาน Auto Split ใหม่ งานนี้จะตัดโมเดลของงานก่อนหน้าออกเป็นชิ้นส่วนที่สามารถพิมพ์แยกกันได้ และส่งคืนโมเดลที่ถูกแบ่งส่วนแล้ว โดยแต่ละชิ้นส่วนจะเป็นอ็อบเจ็กต์ของตัวเองในไฟล์

พารามิเตอร์

Name
input_task_id
Type
string
จำเป็น
Description
ID ของงานที่สำเร็จซึ่งต้องการแบ่งโมเดล ประเภทงานที่รองรับ: รูปภาพเป็น 3D, หลายรูปเป็น 3D, ข้อความเป็น 3D (พรีวิว), รีเมช, แปลง และ ปรับขนาด งานต้องมีสถานะเป็น SUCCEEDED และโมเดลของงานนั้นต้องถูกสร้างด้วย Meshy 6 หรือ Meshy 7 (ai_model เป็น meshy-6, meshy-7 หรือ latest) โมเดลแบบโลว์โพลีและ Smart Topology (meshy-t2) ไม่รองรับ

Name
mode
Type
string
ค่าเริ่มต้น auto
Description
วิธีการแบ่งโมเดลออกเป็นชิ้นส่วน
ค่าที่ใช้ได้:
- auto: Meshy เป็นผู้เลือกจุดตัดเอง prompt จะถูกละเว้น
- by_parts: ตัดตามชิ้นส่วนโครงสร้างที่คุณระบุไว้ใน prompt เช่น ศีรษะ แขน และลำตัว
- by_color: ตัดตามบริเวณสีที่คุณระบุไว้ใน prompt ต้องใช้อินพุตที่สร้างจากภาพที่อัปโหลด (รูปภาพเป็น 3D หรือ หลายรูปเป็น 3D) อินพุตประเภทอื่นจะถูกปฏิเสธด้วย 400

ใช้เฉพาะเมื่อ mode = by_parts or by_color

Name
prompt
Type
string
จำเป็น
Description
อธิบายชิ้นส่วนที่ต้องการแบ่ง โดยใช้ภาษาใดก็ได้ Meshy จะอ่านชื่อชิ้นส่วน 1 ถึง 10 ชิ้นจากข้อความนี้ ดังนั้นให้ระบุชื่อชิ้นส่วนแทนการอธิบายตัวโมเดล เช่น split into the figure and the base หรือ head, torso, left arm, right arm, legs ความยาวไม่เกิน 600 ตัวอักษร มีรูปแบบความล้มเหลวสองแบบ: หากคำอธิบายอ่านได้ว่าเป็นการแบ่งแต่ระบุชิ้นส่วนน้อยกว่าสองชิ้น (เช่น split into individual parts) จะถูกปฏิเสธด้วย 400 และไม่มีการเรียกเก็บเงินใด ๆ; หากคำอธิบายที่ Meshy ไม่สามารถอ่านได้เลย ระบบจะย้อนกลับไปใช้ auto งานจะยังคงทำงานและมีการเรียกเก็บเงิน และการตอบกลับจะมี prompt_ignored: true

Name
target_formats
Type
array
ค่าเริ่มต้น ["glb"]
Description
รูปแบบไฟล์ที่จะใช้ส่งออกโมเดลที่แบ่งแล้ว แต่ละชิ้นส่วนจะเป็นอ็อบเจ็กต์แยกกันในทุกรูปแบบ glb จะถูกสร้างและส่งคืนใน model_urls เสมอ ให้ระบุรูปแบบอื่นที่ต้องการเพิ่มเติม
ค่าที่ใช้ได้: glb, obj, fbx, usdz, blend, 3mf
3mf ถูกเขียนขึ้นสำหรับสไลเซอร์: หนึ่งอ็อบเจ็กต์ต่อหนึ่งชิ้นส่วน แต่ละชิ้นอยู่ในช่องไส้พิมพ์ (filament slot) ของตัวเอง ดังนั้น Bambu Studio จะเปิดไฟล์นี้เป็นชิ้นส่วนที่มีสีแยกกันและเลือกได้แยกกัน (ไฟล์เก็บถาวรนี้มีการตั้งค่าโปรเจกต์ของ Bambu Studio ติดมาด้วย ส่วนสไลเซอร์อื่นจะอ่านเฉพาะจีออเมทรี) เช่นเดียวกับรูปแบบไฟล์สำหรับการพิมพ์อื่น ๆ ของ Meshy ไฟล์นี้มีหน่วยเป็นมิลลิเมตร และเนื่องจากเอนด์พอยต์นี้ไม่มีการกำหนดขนาดเป้าหมาย โมเดลทั้งหมดจะถูกปรับสเกลให้ด้านที่ยาวที่สุดมีขนาด 150 มม. ซึ่งเป็นขีดจำกัดเดียวกันกับที่ใช้ในการส่งออกรูปแบบไฟล์สำหรับการพิมพ์อื่น ๆ โดยเลือกให้พอดีกับแท่นพิมพ์ของเครื่องพิมพ์ทั่วไปส่วนใหญ่ เมื่อใช้ layout: "on_plate" ขีดจำกัดนี้จะถูกใช้กับแท่นพิมพ์ที่จัดวางแล้วทั้งหมด ทำให้ไฟล์พร้อมสำหรับการสไลซ์ทันที ส่วนเมื่อใช้ assembled ชิ้นส่วนต่าง ๆ จะอยู่ในตำแหน่งเดียวกับที่โมเดลต้นฉบับมี และคุณจะต้องจัดเรียงเองในสไลเซอร์
stl ไม่รองรับ เนื่องจากรูปแบบไฟล์นี้ไม่สามารถเก็บชิ้นส่วนแยกกันได้
Name
layout
Type
string
ค่าเริ่มต้น assembled
Description
วิธีการจัดวางชิ้นส่วนในทุกรูปแบบไฟล์ที่ส่งออก และในภาพย่อ
ค่าที่ใช้ได้:
- assembled: ชิ้นส่วนจะอยู่ในตำแหน่งเดียวกับที่โมเดลต้นฉบับมี
- on_plate: ชิ้นส่วนจะถูกวางราบและกระจายออกบนแท่นพิมพ์ พร้อมสำหรับการสไลซ์ — เป็นการจัดวางแบบเดียวกับมุมมอง On Plate ในเว็บแอป
ในทั้งสองรูปแบบการจัดวาง ไฟล์ที่ส่งออกจะมีหนึ่งอ็อบเจ็กต์ต่อหนึ่งชิ้นส่วนเท่านั้น: ชิ้นส่วนที่ยุบตัวเป็นเสี้ยวบางหรือมีลักษณะเป็นจุดที่เหลือจากการตัดจะถูกลบออกก่อนการส่งออก ดังนั้นทุกอ็อบเจ็กต์ที่พบในไฟล์จะสามารถพิมพ์ได้จริง
Name
connectors
Type
boolean
ค่าเริ่มต้น false
Description
เพิ่มตัวเชื่อมแบบเดือย-เข้าเดือย (mortise-and-tenon) ที่จุดตัดแต่ละจุด เพื่อให้ชิ้นส่วนที่พิมพ์ออกมาสามารถประกอบเข้าด้วยกันได้

ใช้เฉพาะเมื่อ connectors = true

Name
connector_type
Type
string
ค่าเริ่มต้น cube
Description
รูปทรงของตัวเชื่อมที่พื้นผิวจุดตัดแต่ละจุด
ค่าที่ใช้ได้: cube, cylinder
Name
connector_size
Type
number
ค่าเริ่มต้น 0.5
Description
ขนาดของตัวเชื่อมเทียบกับพื้นผิวจุดตัด
ช่วงค่าที่ใช้ได้: 0.1 ถึง 0.8
Name
connector_height
Type
number
ค่าเริ่มต้น 0.1
Description
ระยะที่ตัวเชื่อมยื่นออกมาจากพื้นผิวจุดตัด เทียบกับพื้นผิวจุดตัด
ช่วงค่าที่ใช้ได้: 0.1 ถึง 0.8

ค่าที่ส่งคืน

พร็อพเพอร์ตี้ result ของการตอบกลับมี id ของงาน Auto Split ที่สร้างขึ้นใหม่

รูปแบบความล้มเหลว

Name
400 - Bad Request
Description
คำขอไม่สามารถยอมรับได้ สาเหตุที่พบบ่อย:
- ไม่มี prompt: prompt จำเป็นต้องระบุเมื่อ mode เป็น by_parts หรือ by_color
- Prompt ระบุชิ้นส่วนน้อยกว่าสองชิ้น: by_parts / by_color ต้องการชิ้นส่วนที่ระบุชื่ออย่างน้อยสองชิ้น (เช่น head, torso, base) คำสั่งทั่วไปเช่น split into individual parts จะถูกปฏิเสธ และไม่มีการเรียกเก็บเงินใด ๆ
- งานอินพุตไม่รองรับ: input_task_id ต้องอ้างอิงถึงงานที่สำเร็จของประเภทที่รองรับ ซึ่งสร้างขึ้นด้วย Meshy 6 หรือ Meshy 7
- อินพุตมีเท็กซ์เจอร์: โมเดลอินพุตมีเท็กซ์เจอร์ ขณะนี้รองรับเฉพาะโมเดลที่ไม่มีเท็กซ์เจอร์เท่านั้น
- ไม่มีภาพอ้างอิง: by_color ต้องใช้อินพุตที่สร้างจากภาพที่อัปโหลด
- รูปแบบไฟล์ไม่รองรับ: target_formats มี stl
- ตัวเชื่อมมีค่านอกช่วงที่กำหนด: connector_size หรือ connector_height อยู่นอกช่วง 0.1 ถึง 0.8
Name
401 - Unauthorized
Description
การยืนยันตัวตนล้มเหลว โปรดตรวจสอบ API คีย์ของคุณ
Name
402 - Payment Required
Description
เครดิตไม่เพียงพอสำหรับการทำงานนี้
Name
404 - Not Found
Description
input_task_id ไม่มีอยู่จริงหรือไม่ได้เป็นของบัญชีของคุณ
Name
429 - Too Many Requests
Description
คุณเกินการจำกัดอัตราของคุณแล้ว คำขอ by_parts และ by_color ยังใช้ขีดจำกัดร่วมกันในการประมวลผล prompt ที่ 12 คำขอต่อนาทีต่อบัญชี
Name
503 - Service Unavailable
Description
การแบ่งส่วนตาม prompt (by_parts และ by_color) ไม่พร้อมใช้งานชั่วคราว โปรดลองใหม่ภายหลัง หรือใช้ mode: "auto" ซึ่งไม่ได้รับผลกระทบ ไม่มีการเรียกเก็บเงินใด ๆ

Request

POST

/openapi/v1/print/split

# Simple request: let Meshy choose the cuts
curl https://api.meshy.ai/openapi/v1/print/split \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578"
  }'

# Advanced request: name the parts, add connectors, export glb and obj
curl https://api.meshy.ai/openapi/v1/print/split \
-X POST \
-H "Authorization: Bearer ${YOUR_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
    "input_task_id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "mode": "by_parts",
    "prompt": "split into the figure and the base",
    "target_formats": ["glb", "obj"],
    "layout": "on_plate",
    "connectors": true,
    "connector_type": "cylinder",
    "connector_size": 0.4
  }'

Response

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

GET/openapi/v1/print/split/:id

เรียกดูงาน Auto Split

เอนด์พอยต์นี้ใช้เรียกดูงาน Auto Split ตาม ID ของงาน

พารามิเตอร์

Name
id
Type
path
Description
ID ของงาน Auto Split ที่ต้องการเรียกดู

ค่าที่ส่งกลับ

ออบเจ็กต์งาน Auto Split

Request

GET

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

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

Response

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "consumed_credits": 10
}

DELETE/openapi/v1/print/split/:id

ลบงาน Auto Split

เอนด์พอยต์นี้ใช้สำหรับลบงาน Auto Split อย่างถาวร รวมถึงโมเดลและข้อมูลทั้งหมดที่เกี่ยวข้อง การดำเนินการนี้ไม่สามารถย้อนกลับได้

Path Parameters

Name
id
Type
path
Description
ID ของงาน Auto Split ที่ต้องการลบ

สิ่งที่ได้รับกลับมา

ส่งคืน 200 OK เมื่อสำเร็จ

Request

DELETE

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

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

Response

// Returns 200 Ok on success.

GET/openapi/v1/print/split

List Auto Split Tasks

เอนด์พอยต์นี้ช่วยให้คุณสามารถดึงรายการงาน Auto Split ได้

พารามิเตอร์

แอตทริบิวต์ที่ไม่บังคับ

Name
page_num
Type
integer
Description
หมายเลขหน้าสำหรับการแบ่งหน้า เริ่มต้นและมีค่าเริ่มต้นเป็น 1
Name
page_size
Type
integer
Description
จำนวนรายการสูงสุดต่อหน้า ค่าเริ่มต้นคือ 10 รายการ ค่าสูงสุดที่อนุญาตคือ 100 รายการ หากระบุค่ามากกว่านี้จะถูกจำกัดไว้ที่ 100
Name
sort_by
Type
string
Description
ฟิลด์ที่ใช้ในการเรียงลำดับ ค่าที่ใช้ได้:
- +created_at: เรียงลำดับตามเวลาที่สร้างจากน้อยไปมาก
- -created_at: เรียงลำดับตามเวลาที่สร้างจากมากไปน้อย

ค่าที่ส่งกลับ

ส่งคืนรายการแบบแบ่งหน้าของ The Auto Split Task Objects

Request

GET

/openapi/v1/print/split

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

Response

[
  {
    "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
    "type": "print-split",
    "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=***",
    "part_count": 4,
    "progress": 100,
    "status": "SUCCEEDED",
    "preceding_tasks": 0,
    "created_at": 1699999999000,
    "started_at": 1700000000000,
    "finished_at": 1700000082000,
    "task_error": null,
    "consumed_credits": 10
  }
]

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

สตรีมงาน Auto Split

เอนด์พอยต์นี้จะสตรีมข้อมูลอัปเดตแบบเรียลไทม์สำหรับงาน Auto Split โดยใช้ Server-Sent Events (SSE)

พารามิเตอร์

Name
id
Type
path
Description
ตัวระบุเฉพาะสำหรับงาน Auto Split ที่ต้องการสตรีม

สิ่งที่ได้รับกลับมา

ส่งคืนสตรีมของ The Auto Split Task Objects ในรูปแบบ Server-Sent Events

ทุกอีเวนต์ message จะมีอ็อบเจกต์งานฉบับเต็มตามที่ส่งคืนโดย Retrieve an Auto Split Task รวมถึง consumed_credits, ไทม์สแตมป์ต่างๆ และ prompt_ignored; ในขณะที่งานยังอยู่ในสถานะ PENDING หรือ IN_PROGRESS ฟิลด์ที่เปลี่ยนแปลงระหว่างแต่ละเฟรมคือ progress, status, started_at และ preceding_tasks ส่วน model_urls, thumbnail_url, part_count และ parts จะปรากฏขึ้นเมื่อสถานะถึง SUCCEEDED แล้ว อีเวนต์ error จะมีเพียง status_code และ message เท่านั้น ดังนั้นควรแยกกรณีตามชื่ออีเวนต์ก่อนที่จะอ่านค่า status

Request

GET

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

curl -N https://api.meshy.ai/openapi/v1/print/split/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 (other task fields omitted here for brevity;
// each frame is the full task object).
event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "a43b5c6d-7e8f-901a-234b-567c890d1e2f",
  "type": "print-split",
  "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=***",
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "consumed_credits": 10
}

The Auto Split Task Object

งาน Auto Split จะมีเพียงคุณสมบัติด้านล่างนี้เท่านั้น ฟิลด์ที่เกี่ยวกับ generation prompt ซึ่งอ็อบเจ็กต์งานอื่น ๆ มี (name, object_prompt, texture_prompt และอื่น ๆ) รวมถึง model_url เดี่ยว และ texture_urls จะไม่ถูกกำหนดค่าสำหรับการ split และจะไม่ถูกส่งกลับมา คุณสมบัติที่จะถูกเติมค่าขณะที่งานกำลังทำงาน (thumbnail_url, model_urls, ไทม์สแตมป์ต่าง ๆ) จะปรากฏอยู่เสมอ โดยจะว่างเปล่าจนกว่าจะมีค่า ดังนั้นชุดคีย์จะไม่เปลี่ยนแปลงระหว่างสถานะ PENDING และ SUCCEEDED

Name
id
Type
string
Description
ตัวระบุที่ไม่ซ้ำกันสำหรับงาน แม้ว่าเราจะใช้ k-sortable UUID สำหรับ id ของงานในรายละเอียดการใช้งาน แต่คุณไม่ควรตั้งสมมติฐานใด ๆ เกี่ยวกับรูปแบบของ id
Name
type
Type
string
Description
ประเภทของงาน ค่านี้คือ print-split
Name
model_urls
Type
object
Description
URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้ว โดยมีหนึ่ง URL ต่อรูปแบบไฟล์ที่ร้องขอ แต่ละส่วนจะเป็นอ็อบเจ็กต์แยกต่างหากในไฟล์ คุณสมบัติสำหรับรูปแบบไฟล์จะถูกละไว้หากไม่ได้ร้องขอรูปแบบไฟล์นั้น
- Name
  glb
  Type
  string
  Description
  URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ GLB
- Name
  obj
  Type
  string
  Description
  URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ OBJ
- Name
  fbx
  Type
  string
  Description
  URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ FBX
- Name
  usdz
  Type
  string
  Description
  URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ USDZ
- Name
  blend
  Type
  string
  Description
  URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ Blender
- Name
  3mf
  Type
  string
  Description
  URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ 3MF: หนึ่งอ็อบเจ็กต์ต่อหนึ่งส่วน โดยแต่ละส่วนอยู่ในช่อง filament ของตัวเอง วัดเป็นมิลลิเมตร ปรับสเกลให้ด้านที่ยาวที่สุดมีขนาด 150 มม. พร้อมการตั้งค่าโปรเจกต์ Bambu Studio
Name
thumbnail_url
Type
string
Description
URL สำหรับดาวน์โหลดภาพตัวอย่างที่เรนเดอร์แล้วของโมเดลที่ถูก split โดยแต่ละส่วนจะมีสีที่แตกต่างกัน ในรูปแบบ layout ที่ร้องขอ
Name
prompt_ignored
Type
boolean
Description
เป็น true เมื่อ prompt ของคำขอแบบ by_parts หรือ by_color ไม่ได้ระบุชื่อส่วนใด ๆ ทำให้ Meshy ทำการ split โมเดลโดยอัตโนมัติแทน — ชื่อส่วนในผลลัพธ์จะเป็นชื่อที่ Meshy ตั้งขึ้นเอง ไม่ใช่ชื่อของคุณ ปรากฏตั้งแต่สถานะ PENDING เป็นต้นไป จะถูกละไว้สำหรับงานแบบ auto และเมื่อใดก็ตามที่ prompt ถูกปฏิบัติตาม
Name
part_count
Type
integer
Description
จำนวนส่วนที่พิมพ์ได้ในโมเดลที่ถูก split — หนึ่งส่วนต่อหนึ่งอ็อบเจ็กต์ในไฟล์ที่ส่งออก เศษชิ้นส่วนขนาดเล็กที่ยุบตัวซึ่งการแบ่งส่วนไม่สามารถทำให้กลายเป็นชิ้นที่พิมพ์ได้จะถูกลบออกจากไฟล์ก่อนส่งออก และจะไม่ถูกนับรวม
Name
progress
Type
integer
Description
progress ของงาน หากงานยังไม่เริ่ม คุณสมบัตินี้จะเป็น 0 เมื่องานสำเร็จแล้ว ค่านี้จะกลายเป็น 100
Name
status
Type
string
Description
สถานะของงาน ค่าที่เป็นไปได้คือค่าใดค่าหนึ่งจาก PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED
Name
preceding_tasks
Type
integer
Description
จำนวนของงานที่อยู่ก่อนหน้า
ค่าของฟิลด์นี้จะมีความหมายก็ต่อเมื่อสถานะของงานเป็น PENDING
Name
created_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่สร้างงาน หน่วยเป็นมิลลิวินาที
Name
started_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่งานเริ่มทำงาน หน่วยเป็นมิลลิวินาที หากงานยังไม่เริ่ม คุณสมบัตินี้จะเป็น 0
Name
finished_at
Type
timestamp
Description
ไทม์สแตมป์ของเวลาที่งานเสร็จสิ้น หน่วยเป็นมิลลิวินาที หากงานยังไม่เสร็จสิ้น คุณสมบัตินี้จะเป็น 0
Name
task_error
Type
object
Description
รายละเอียดข้อผิดพลาดสำหรับงานที่ล้มเหลว ดู ข้อผิดพลาด สำหรับข้อมูลอ้างอิงฉบับเต็มของอ็อบเจ็กต์ task_error
Name
consumed_credits
Type
integer
Description
จำนวนเครดิตที่ถูกใช้ไปโดยงานนี้ ปรากฏอยู่เสมอ: 10 เมื่องานได้รับการยอมรับแล้ว และ 0 สำหรับงานที่ FAILED เนื่องจากค่าใช้จ่ายจะถูกคืนเมื่อล้มเหลว การลบงานในขณะที่ยังอยู่ในสถานะ PENDING ก็จะได้รับการคืนเครดิตเช่นกัน

The Auto Split Task Object

{
  "id": "0193bfc5-ee4f-73f8-8525-44b398884ce9",
  "type": "print-split",
  "model_urls": {
    "glb": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.glb?Expires=***",
    "obj": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/model.obj?Expires=***"
  },
  "thumbnail_url": "https://assets.meshy.ai/***/tasks/0193bfc5-ee4f-73f8-8525-44b398884ce9/output/preview.png?Expires=***",
  "part_count": 4,
  "progress": 100,
  "status": "SUCCEEDED",
  "preceding_tasks": 0,
  "created_at": 1699999999000,
  "started_at": 1700000000000,
  "finished_at": 1700000082000,
  "task_error": null,
  "consumed_credits": 10
}