Auto Split API

ID ของงานที่ต้องการแบ่งโมเดล งานนั้นต้องมีสถานะ SUCCEEDED ประเภทงานต่อไปนี้ใช้ได้:

• รูปภาพเป็น 3D
• หลายรูปเป็น 3D
• ข้อความเป็น 3D งาน preview หรือ refine
• รีเท็กซ์เจอร์
• รีเมช
• แปลง
• ปรับขนาด

โมเดลต้องถูกสร้างด้วย Meshy 6 หรือ Meshy 7 นั่นคือ ตั้งค่า ai_model เป็น meshy-6-lite, meshy-6, meshy-7, meshy-7.1 หรือ latest โมเดล Smart Topology (meshy-t2 และ meshy-t2.5) ไม่รองรับ สำหรับงาน refine, รีเท็กซ์เจอร์, รีเมช, แปลง หรือปรับขนาด กฎนี้ใช้กับโมเดลที่งานนั้นเริ่มต้นจาก งานรีเท็กซ์เจอร์, รีเมช, แปลง หรือปรับขนาดที่สร้างจากโมเดลที่อัปโหลดจะคืนค่า 400

โมเดลสามารถมีได้สูงสุด 8,000,000 หน้า โมเดลที่มีหน้ามากกว่านี้จะคืนค่า 400 ในกรณีนั้น ให้รันงานรีเมชกับโมเดลนั้นก่อน แล้วส่ง ID ของงานรีเมชแทน

คุณสามารถแบ่งโมเดลที่มีเท็กซ์เจอร์ได้ หากต้องการให้ชิ้นส่วนคงเท็กซ์เจอร์ไว้ ให้ส่ง keep_texture: true

วิธีแบ่งโมเดลออกเป็นชิ้นส่วน

ค่าที่ใช้ได้:

• auto: Meshy เลือกตำแหน่งตัดเองและละเลย prompt prompt ที่ยาวเกิน 600 ตัวอักษรยังคืนค่า 400 อยู่ดี
• by_parts: Meshy ตัดตามโครงสร้างชิ้นส่วนที่คุณระบุใน prompt เช่น ศีรษะ แขน และลำตัว
• by_color: Meshy ตัดตามพื้นที่สีที่คุณระบุใน prompt Meshy จะหาพื้นที่เหล่านี้จากภาพต้นฉบับ ไม่ใช่จากเท็กซ์เจอร์ของโมเดลอินพุต อินพุตต้องถูกสร้างจากภาพที่อัปโหลด ด้วย รูปภาพเป็น 3D หรือ หลายรูปเป็น 3D อินพุตแบบอื่นจะคืนค่า 400 สำหรับหลายรูปเป็น 3D Meshy จะใช้ภาพต้นฉบับภาพแรก

รูปแบบไฟล์ที่จะสร้าง Meshy จะสร้าง glb เสมอและคืนค่าใน model_urls พร้อมกับรูปแบบอื่นๆ ที่คุณระบุ

ค่าที่ใช้ได้:

• glb
• obj
• fbx
• stl
• usdz
• blend
• 3mf

ทุกรูปแบบยกเว้น stl รองรับอ็อบเจกต์ในซีนและเก็บแต่ละชิ้นส่วนเป็นอ็อบเจกต์แยกกัน ไฟล์ STL ไม่สามารถเก็บอ็อบเจกต์แยกกันได้ ดังนั้น Meshy จะรวมชิ้นส่วนเข้าด้วยกันเป็นชิ้นเดียว โดยจัดเรียงตาม layout หากต้องการชิ้นส่วนที่สามารถเลือกแยกกันได้ในสไลเซอร์ ให้ขอ 3mf

เมื่อตั้งค่า keep_texture: true รูปแบบเหล่านี้จะเก็บเท็กซ์เจอร์ไว้:

• glb, fbx, usdz และ blend: เท็กซ์เจอร์อยู่ในไฟล์
• obj: เท็กซ์เจอร์อยู่ในไฟล์แมททีเรียล ซึ่ง model_urls จะคืนค่าภายใต้ mtl
• stl และ 3mf: ไฟล์เก็บเฉพาะจีออเมทรีเท่านั้น โดยไม่มีเท็กซ์เจอร์

วิธีที่ Meshy จัดเรียงชิ้นส่วน ในทุกรูปแบบไฟล์และในภาพย่อ

ค่าที่ใช้ได้:

• assembled: Meshy จะคงชิ้นส่วนไว้ในตำแหน่งเดิมตามโมเดลต้นฉบับ
• on_plate: Meshy จะวางชิ้นส่วนให้แบนราบและกระจายออกบนแผ่นพิมพ์ พร้อมสำหรับการสไลซ์ นี่คือการจัดเรียงแบบเดียวกับมุมมอง On Plate ในเว็บแอป

ทั้งสอง layout นี้ Meshy จะเอาชิ้นส่วนที่บางหรือมีลักษณะเป็นจุดที่เหลือจากการตัดออกก่อนการส่งออก เพื่อให้ทุกชิ้นส่วนที่คุณได้รับสามารถพิมพ์ได้ รูปแบบที่รองรับอ็อบเจกต์ในซีนจะเก็บหนึ่งอ็อบเจกต์ต่อหนึ่งชิ้นส่วน และ stl จะรวมชิ้นส่วนเข้าด้วยกันเป็นชิ้นเดียว

ว่าจะคงเท็กซ์เจอร์ของโมเดลอินพุตไว้บนชิ้นส่วนหรือไม่ true จะให้ทุกชิ้นส่วนมีเท็กซ์เจอร์ของอินพุต และงานจะคืนค่าแมปใน texture_urls false จะให้แต่ละชิ้นส่วนมีสีจุดยอดแบบเรียบ

เมื่อตั้งค่าเป็น true งานจะใช้เวลานานขึ้นประมาณสองเท่า และค่าใช้จ่ายเครดิตจะไม่เปลี่ยนแปลง อินพุตที่ไม่มีเท็กซ์เจอร์จะถูกแบ่งในลักษณะเดียวกับเมื่อตั้งค่าเป็น false หาก Meshy ไม่สามารถคงเท็กซ์เจอร์ไว้ได้ งานจะล้มเหลวพร้อมรหัสข้อผิดพลาด textured_split_refused ดูที่ ข้อผิดพลาด

ว่าจะเพิ่มตัวเชื่อมแบบเดือยและเบ้า (mortise-and-tenon) ที่แต่ละจุดตัดหรือไม่ เพื่อให้ชิ้นส่วนที่พิมพ์ออกมาประกอบเข้ากันได้

คำขอไม่สามารถทำงานได้ ข้อความแสดงข้อผิดพลาดจะบอกว่าพบปัญหาใด ตัวอย่างเช่น:

• ไม่มี prompt: mode เป็น by_parts หรือ by_color และไม่มี prompt
• prompt อธิบายว่าไม่มีการแบ่ง หรือมีชิ้นส่วนมากเกินไป: prompt ขอให้คงโมเดลไว้เป็นชิ้นเดียว หรือระบุชิ้นส่วนมากกว่า 10 ชิ้น by_parts และ by_color รองรับชิ้นส่วนที่ระบุชื่อได้ 1 ถึง 10 ชิ้น Meshy จะไม่คิดเครดิตสำหรับคำขอนี้
• งานอินพุตไม่รองรับ: input_task_id ไม่ใช่งานที่สำเร็จของประเภทที่รองรับ ซึ่งสร้างด้วย Meshy 6 หรือ Meshy 7
• ไม่มีภาพอ้างอิง: mode เป็น by_color และอินพุตไม่ได้ถูกสร้างจากภาพที่อัปโหลด
• ตัวเชื่อมนอกช่วงที่กำหนด: connector_size หรือ connector_height อยู่นอกช่วง 0.1 ถึง 0.8

แก้ไขคำขอ แล้วส่งใหม่อีกครั้ง ดูที่ ข้อผิดพลาด

API คีย์หายไปหรือไม่ถูกต้อง ตรวจสอบเฮดเดอร์ Authorization

ตัวอย่างเช่น:

• เครดิตไม่เพียงพอ: บัญชีมีเครดิตไม่เพียงพอสำหรับงานนี้ หรือบัญชีถึงขีดจำกัดเครดิตแล้ว ตรวจสอบยอดคงเหลือเครดิตของคุณ แล้วลองใหม่
• แพ็กเกจฟรี: การสร้างงานต้องใช้แพ็กเกจแบบชำระเงิน อัปเกรดแพ็กเกจของคุณในการตั้งค่าการสมัครสมาชิก แล้วลองใหม่

หนึ่งในกรณีต่อไปนี้:

• การตรวจสอบเนื้อหาบล็อก prompt ข้อความคือ explicit content หรือ prohibited content เปลี่ยน prompt แล้วลองใหม่
• input_task_id เป็นโมเดลภาพนูนต่ำ (bas-relief) ซึ่งเอนด์พอยต์นี้ไม่สามารถแบ่งได้ ข้อความคือ This model type does not support this operation ส่งโมเดลอื่นแทน

input_task_id ไม่มีอยู่หรือไม่ได้เป็นของบัญชีคุณ ตรวจสอบ ID และใช้ API คีย์จากบัญชีที่สร้างงานนั้น

คุณเกินการจำกัดอัตราแล้ว รอสักครู่แล้วลองใหม่ ดูที่ การจำกัดอัตรา

คำขอ by_parts และ by_color ยังใช้ขีดจำกัดการอ่าน prompt ร่วมกันที่ 12 คำขอต่อนาทีต่อบัญชี

การแบ่งตาม prompt (by_parts และ by_color) ไม่พร้อมใช้งานชั่วคราว ลองใหม่ภายหลัง หรือส่ง mode: "auto" ซึ่งยังคงใช้งานได้ Meshy จะไม่คิดเครดิตสำหรับคำขอนี้

รหัสงานจากการตอบกลับการสร้างงาน

ID ของงานที่ต้องการลบ

หมายเลขหน้าที่ต้องการคืนค่า เริ่มต้นและมีค่าเริ่มต้นเป็น 1

จำนวนงานต่อหน้า สูงสุด 100 ค่าเริ่มต้นคือ 10 Meshy จะถือว่าค่าที่มากกว่านี้เป็น 100

ลำดับการเรียง

ค่าที่สามารถใช้ได้:

• +created_at: เก่าสุดก่อน
• -created_at: ใหม่สุดก่อน

รหัสงานจากคำตอบของคำขอสร้างงาน

รหัสของงาน ให้ถือว่าเป็นสตริงที่ไม่มีความหมายตายตัว และอย่าอ้างอิงรูปแบบของมัน

ประเภทของงาน ซึ่งจะเป็น print-split เสมอ

URL สำหรับดาวน์โหลดโมเดลที่ถูกแบ่งแล้ว หนึ่ง URL ต่อหนึ่งฟอร์แมตที่คุณขอ ฟอร์แมตที่คุณไม่ได้ขอจะไม่มีคีย์ปรากฏ ฟอร์แมตที่รองรับอ็อบเจกต์ของซีนจะเก็บแต่ละชิ้นส่วนเป็นอ็อบเจกต์แยกกัน ส่วน stl จะรวมทุกชิ้นส่วนเข้าเป็นชิ้นเดียว

URL สำหรับดาวน์โหลดภาพตัวอย่างของโมเดลที่ถูกแบ่งแล้ว ใน layout ที่คุณขอ เมื่อชิ้นส่วนยังคงเท็กซ์เจอร์ไว้ ภาพตัวอย่างจะแสดงเท็กซ์เจอร์นั้น มิฉะนั้นแต่ละชิ้นส่วนจะมีสีของตัวเอง

แผนที่เท็กซ์เจอร์ของโมเดลที่ถูกแบ่งแล้ว เป็นอาร์เรย์ที่มีหนึ่งอ็อบเจกต์ ทุกชิ้นส่วนใช้แผนที่เหล่านี้ร่วมกัน จะปรากฏเฉพาะเมื่อ keep_texture เป็น true และโมเดลนำเข้ามีเท็กซ์เจอร์

URL สำหรับดาวน์โหลดเวอร์ชันของ thumbnail_url ที่มีพื้นหลังโปร่งใส (RGBA) จะปรากฏเฉพาะหลังจากงานสำเร็จ เมื่อ Meshy เรนเดอร์ภาพตัวอย่างแบบโปร่งใสแล้ว

ระบุว่า Meshy เพิกเฉยต่อ prompt หรือไม่ ค่านี้จะเป็น true เมื่อ prompt ของคำขอแบบ by_parts หรือ by_color ไม่ได้ระบุชื่อชิ้นส่วนใด ๆ ทำให้ Meshy แบ่งโมเดลโดยอัตโนมัติแทน ชื่อชิ้นส่วนในผลลัพธ์จะเป็นชื่อที่ Meshy ตั้งให้ ไม่ใช่ของคุณ ฟิลด์นี้จะปรากฏตั้งแต่สถานะ PENDING เป็นต้นไป Meshy จะไม่ใส่ฟิลด์นี้สำหรับงานแบบ auto และเมื่อใดก็ตามที่ทำตาม prompt แล้ว

จำนวนชิ้นส่วนที่พิมพ์ได้ซึ่งการแบ่งนี้สร้างขึ้น ฟอร์แมตที่รองรับอ็อบเจกต์ของซีนจะมีหนึ่งอ็อบเจกต์ต่อหนึ่งชิ้นส่วน stl รวมทุกชิ้นส่วนเข้าเป็นชิ้นเดียว แต่ part_count ยังคงนับจำนวนชิ้นส่วนอยู่ ก่อนส่งออก Meshy จะลบส่วนที่ยุบตัวบางเกินกว่าจะเป็นชิ้นส่วนที่พิมพ์ได้ออกไป และไม่นับรวมส่วนเหล่านั้น

ความคืบหน้าของงาน เป็นเปอร์เซ็นต์ โดยจะเป็น 0 จนกว่างานจะเริ่ม และเป็น 100 เมื่องานสำเร็จ

สถานะของงาน หนึ่งใน PENDING, IN_PROGRESS, SUCCEEDED, FAILED หรือ CANCELED

จำนวนงานที่อยู่ก่อนหน้างานนี้ในคิว ค่านี้มีความหมายก็ต่อเมื่องานยังอยู่ในสถานะ PENDING เท่านั้น

เวลาที่สร้างงาน หน่วยเป็นมิลลิวินาทีแบบ Unix

เวลาที่งานเริ่มทำงาน หน่วยเป็นมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่างานจะเริ่ม

เวลาที่งานเสร็จสิ้น หน่วยเป็นมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่างานจะเสร็จสิ้น

เวลาที่ผลลัพธ์ของงานจะหมดอายุ หน่วยเป็นมิลลิวินาทีแบบ Unix โดยจะเป็น 0 จนกว่างานจะเสร็จสิ้น

รายละเอียดข้อผิดพลาดเมื่องานล้มเหลว ดูข้อผิดพลาด

หากการตรวจสอบความปลอดภัยปฏิเสธโมเดลที่นำเข้า งานจะล้มเหลวโดยตั้งค่า task_error.type เป็น invalid_input และ task_error.code เป็น provider_content_refused โปรดส่งโมเดลอื่น ดูข้อผิดพลาด

เมื่อตั้งค่า keep_texture: true หาก Meshy ไม่สามารถคงเท็กซ์เจอร์ไว้ได้ งานจะล้มเหลวโดยตั้งค่า task_error.code เป็น textured_split_refused ดูข้อผิดพลาด

จำนวนเครดิตที่งานนี้ใช้ไป ฟิลด์นี้จะปรากฏอยู่เสมอ โดยจะเป็น 10 หลังจาก Meshy ยอมรับงาน และเป็น 0 สำหรับงานที่ FAILED เนื่องจาก Meshy จะคืนเครดิตเมื่องานล้มเหลว การลบงานที่ยังอยู่ในสถานะ PENDING ก็จะได้รับการคืนเครดิตเช่นกัน