Auto Split API
แยกโมเดล 3 มิติออกเป็นชิ้นส่วนที่พิมพ์แยกกันได้ — โดยอัตโนมัติ ตามชื่อชิ้นส่วนที่คุณกำหนด หรือตามบริเวณสี — พร้อมตัวเชื่อมต่อที่เป็นทางเลือก บริเวณที่บางลงจากการตัดจะได้รับการเสริมความแข็งแรงเสมอ เพื่อให้ทุกชิ้นส่วนพิมพ์ออกมาแบบทึบ
ผลลัพธ์การแยกจะไม่คงเท็กซ์เจอร์ของอินพุตไว้ Auto Split รองรับอินพุตที่มีเท็กซ์เจอร์ ดังนั้นคุณไม่จำเป็นต้องสร้างโมเดลใหม่ด้วย should_texture: false ระบบจะสร้างชิ้นส่วนที่ถูกตัดขึ้นใหม่และกำหนดสีจุดยอด (vertex color) แบบเรียบให้กับแต่ละชิ้นส่วน โดยไม่มีแผนที่เท็กซ์เจอร์ของอินพุตใดๆ ถูกนำไปรวมไว้ในรูปแบบไฟล์ที่ส่งออก
สร้างงาน 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,meshy-7.1, หรือlatest) โมเดลแบบโลว์โพลีและ Smart Topology (meshy-t2) ไม่รองรับ โมเดลที่มีเท็กซ์เจอร์สามารถใช้ได้ แต่เท็กซ์เจอร์ของโมเดลนั้นจะไม่ถูกนำไปใช้ในผลลัพธ์
- Name
- mode
- Type
- string
- ค่าเริ่มต้น auto
- Description
วิธีการแบ่งโมเดลออกเป็นชิ้นส่วนต่างๆ
ค่าที่ใช้ได้:
auto: Meshy เป็นผู้เลือกจุดตัดเอง โดยจะไม่สนใจpromptby_parts: ตัดตามชิ้นส่วนโครงสร้างที่คุณระบุไว้ในpromptเช่น หัว แขน และลำตัวby_color: ตัดตามบริเวณสีที่คุณระบุไว้ในpromptต้องใช้อินพุตที่สร้างจากรูปภาพที่อัปโหลด (รูปภาพเป็น 3D หรือ หลายรูปเป็น 3D) อินพุตประเภทอื่นจะถูกปฏิเสธด้วย400ขอบเขตของบริเวณสีมาจากรูปภาพต้นทาง ไม่ใช่จากเท็กซ์เจอร์ของโมเดลอินพุต สำหรับหลายรูปเป็น 3D นั้น Auto Split จะใช้รูปภาพต้นทางรูปแรก
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การตั้งชื่อเพียงชิ้นเดียวก็ทำได้เช่นกัน โดยส่วนที่คุณไม่ได้ตั้งชื่อจะกลายเป็นชิ้นส่วนที่เหลืออีกหนึ่งชิ้น ดังนั้นthe headจะแบ่งโมเดลออกเป็นส่วนหัวและส่วนที่เหลือ เช่นเดียวกับในเว็บแอป สูงสุด 600 ตัวอักษร มีรูปแบบความล้มเหลวสองแบบ ได้แก่ คำอธิบายที่ขอให้ไม่แบ่งเลย หรือระบุชิ้นส่วนมากกว่า 10 ชิ้น จะถูกปฏิเสธด้วย400และจะไม่มีการคิดเครดิต ส่วนคำอธิบายที่ Meshy ไม่สามารถอ่านเข้าใจได้เลยจะย้อนกลับไปใช้autoโดยงานนั้นยังคงดำเนินการและถูกคิดเครดิตตามปกติ และการตอบกลับจะมีprompt_ignored: true
- Name
- target_formats
- Type
- array
- ค่าเริ่มต้น ["glb"]
- Description
รูปแบบไฟล์ที่จะใช้ส่งออกโมเดลที่แบ่งแล้ว รูปแบบที่รองรับออบเจ็กต์แบบซีน (
glb,obj,fbx,usdz,blend,3mf) จะเก็บแต่ละชิ้นส่วนเป็นออบเจ็กต์แยกกัน ส่วนstlไม่มีแนวคิดเรื่องออบเจ็กต์แยกกัน จึงหลอมรวมทุกชิ้นส่วนเป็นชิ้นเดียวโดยจัดเรียงตามlayout(ให้ขอ3mfหากต้องการชิ้นส่วนที่สามารถเลือกแยกกันได้ในสไลเซอร์)glbจะถูกสร้างและส่งคืนในmodel_urlsเสมอ ให้ระบุรูปแบบอื่นๆ ที่ต้องการเพิ่มเติมในรายการนี้ค่าที่ใช้ได้:
glb,obj,fbx,stl,usdz,blend,3mf
- Name
- layout
- Type
- string
- ค่าเริ่มต้น assembled
- Description
วิธีการจัดเรียงชิ้นส่วนต่างๆ ในทุกรูปแบบไฟล์ผลลัพธ์ รวมถึงในภาพย่อ
ค่าที่ใช้ได้:
assembled: ชิ้นส่วนต่างๆ อยู่ในตำแหน่งเดียวกับที่โมเดลต้นฉบับมีon_plate: ชิ้นส่วนต่างๆ ถูกวางราบและกระจายออกบนแท่นพิมพ์ พร้อมสำหรับการสไลซ์ — เป็นการจัดเรียงแบบเดียวกับมุมมอง On Plate ของเว็บแอป
ในทั้งสอง layout ชิ้นส่วนที่ยุบตัวเป็นเสี้ยนบางหรือมีลักษณะคล้ายจุดที่เหลือจากการตัดจะถูกลบออกก่อนการส่งออก ดังนั้นทุกชิ้นส่วนที่คุณได้รับจะสามารถพิมพ์ได้จริง รูปแบบไฟล์ที่รองรับออบเจ็กต์แบบซีนจะเก็บหนึ่งออบเจ็กต์ต่อหนึ่งชิ้นส่วน ส่วน
stlจะหลอมรวมทุกชิ้นส่วนเป็นชิ้นเดียว
- 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รองรับชิ้นส่วนที่ตั้งชื่อได้ 1 ถึง 10 ชิ้น คำอธิบายที่ขอให้คงโมเดลไว้เป็นชิ้นเดียว หรือระบุชิ้นส่วนมากกว่า 10 ชิ้น จะถูกปฏิเสธ และจะไม่มีการคิดเครดิต - งานอินพุตไม่รองรับ:
input_task_idต้องอ้างอิงถึงงานที่สำเร็จของประเภทที่รองรับ ซึ่งสร้างด้วย Meshy 6 หรือ Meshy 7 - ไม่มีรูปภาพอ้างอิง:
by_colorต้องใช้อินพุตที่สร้างจากรูปภาพที่อัปโหลด - ค่าตัวเชื่อมอยู่นอกช่วงที่กำหนด:
connector_sizeหรือconnector_heightอยู่นอกช่วง0.1ถึง0.8
- ไม่มี prompt: จำเป็นต้องระบุ
- 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
# 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"
}
เรียกดูงาน Auto Split
เอนด์พอยต์นี้ใช้เรียกดูงาน Auto Split ตามรหัส (ID) ของงานนั้น
พารามิเตอร์
- Name
- id
- Type
- path
- Description
รหัส (ID) ของงาน Auto Split ที่ต้องการเรียกดู
ผลลัพธ์ที่ได้
ออบเจ็กต์งาน Auto Split
Request
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
}
ลบ Auto Split Task
เอนด์พอยต์นี้จะลบ Auto Split task อย่างถาวร รวมถึงโมเดลและข้อมูลทั้งหมดที่เกี่ยวข้อง การดำเนินการนี้ไม่สามารถย้อนกลับได้
Path Parameters
- Name
- id
- Type
- path
- Description
ID ของ Auto Split task ที่ต้องการลบ
สถานะของ Task
task ที่ยังอยู่ในสถานะ PENDING จะถูกลบและเครดิตที่ถูกใช้ไป
ตอนสร้างจะได้รับการคืนเงิน
task ที่อยู่ในสถานะ IN_PROGRESS แล้วจะไม่สามารถลบได้ คำขอจะถูกปฏิเสธ
ด้วย 409 Conflict และ task จะยังคงทำงานต่อไป เครดิตสำหรับ task ที่
worker เริ่มดำเนินการไปแล้วจะไม่สามารถขอคืนได้ ดังนั้นการลบ task ระหว่าง
ที่กำลังทำงานอยู่จะทำให้คุณเสียทั้งเครดิตและผลลัพธ์ ให้รอจนกว่า task จะถึง
สถานะ SUCCEEDED, FAILED หรือ CANCELED แล้วจึงค่อยลบ
task ที่อยู่ในสถานะสุดท้าย (SUCCEEDED, FAILED หรือ CANCELED) จะถูกลบ
โดยไม่มีการคืนเครดิต
ค่าที่ส่งกลับ
ส่งกลับ 200 OK เมื่อสำเร็จ หรือ 409 Conflict เมื่อ task อยู่ในสถานะ
IN_PROGRESS
Request
curl --request DELETE \
--url https://api.meshy.ai/openapi/v1/print/split/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."
}
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
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
}
]
สตรีมงาน 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, timestamp ต่าง ๆ และ prompt_ignored; ในขณะที่งานอยู่ในสถานะ PENDING หรือ IN_PROGRESS ฟิลด์ที่เปลี่ยนแปลงระหว่างแต่ละเฟรมคือ progress, status, started_at และ preceding_tasks ส่วน model_urls, thumbnail_url และ part_count จะปรากฏขึ้นเมื่อสถานะถึง SUCCEEDED เหตุการณ์ error จะมีเพียง status_code และ message เท่านั้น ดังนั้นควรแยกกรณีตามชื่อเหตุการณ์ก่อนที่จะอ่านค่า status
Request
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 ต่อหนึ่งฟอร์แมตที่ร้องขอ ฟอร์แมตที่รองรับออบเจ็กต์ในซีนจะเก็บแต่ละส่วนไว้เป็นออบเจ็กต์แยกกัน ส่วน
stlจะรวมทุกส่วนเข้าเป็นชิ้นทึบชิ้นเดียว พร็อพเพอร์ตี้สำหรับฟอร์แมตหนึ่ง ๆ จะถูกละไว้หากไม่ได้มีการร้องขอฟอร์แมตนั้น- 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
stl- Type
- string
- Description
URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ STL ทุกส่วนจะถูกรวมเข้าเป็นชิ้นทึบชิ้นเดียว ให้ร้องขอ
3mfหากต้องการชิ้นส่วนที่สามารถเลือกแยกกันได้
- Name
usdz- Type
- string
- Description
URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ USDZ
- Name
blend- Type
- string
- Description
URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ Blender
- Name
3mf- Type
- string
- Description
URL สำหรับดาวน์โหลดโมเดลที่ถูก split แล้วในรูปแบบ 3MF
- 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 ฟอร์แมตที่รองรับออบเจ็กต์ในซีนจะมีหนึ่งออบเจ็กต์ต่อหนึ่งชิ้นส่วน ส่วน
stlจะรวมทุกชิ้นเข้าเป็นชิ้นทึบชิ้นเดียว แต่จำนวนที่รายงานยังคงเป็นจำนวนชิ้นส่วนอยู่ ชิ้นส่วนบาง ๆ ที่ยุบตัวซึ่งการแบ่งส่วนไม่สามารถทำให้เป็นชิ้นที่พิมพ์ได้จะถูกลบออกจากไฟล์ก่อนการส่งออก และจะไม่ถูกนับรวม
- Name
- progress
- Type
- integer
- Description
ความคืบหน้าของงาน หากงานยังไม่เริ่มดำเนินการ พร็อพเพอร์ตี้นี้จะเป็น
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
}