lowpoly จะยุติการให้บริการในวันที่ 30 ต.ค. 2569 โปรดเปลี่ยนโมเดลก่อนวันที่เหล่านี้เพื่อหลีกเลี่ยงข้อผิดพลาดของคำขอ ดูการเลิกใช้งานทั้งหมด

วงจรชีวิตของทาสก์

เรียนรู้ว่าทาสก์เคลื่อนที่จากคำขอไปจนถึงผลลัพธ์อย่างไร ใช้เวลานานเท่าใดโดยทั่วไป และโค้ดของคุณควรรอนานแค่ไหน

การทำงานของทาสก์

คำขอสร้างจะส่งคืนรหัสทาสก์โดยไม่รอให้ทาสก์ทำงานเสร็จ จากนั้นทาสก์จะทำงานในพื้นหลัง และคุณสามารถติดตามได้สามวิธี ได้แก่ การโพลเอนด์พอยต์ GET ของมัน การเปิดเอนด์พอยต์สตรีมของมัน หรือการรับ webhook

คำขอสร้างจะเริ่มทาสก์ในสถานะ PENDING เมื่อ worker รับงานแล้ว ทาสก์จะเปลี่ยนไปเป็น IN_PROGRESS ซึ่งเป็นสถานะที่ใช้เวลาส่วนใหญ่อยู่ในนั้น และจะจบลงที่ SUCCEEDED หรือ FAILED โดยสถานะสุดท้ายจะไม่เปลี่ยนแปลงอีก
คำขอสร้าง
PENDING
กำลังรอในคิว
IN_PROGRESS
กำลังสร้างผลลัพธ์
SUCCEEDED
ดาวน์โหลดผลลัพธ์
FAILED
คืนเครดิตแล้ว

ทาสก์จะบันทึกแต่ละขั้นตอนไว้ในฟิลด์ created_at, started_at และ finished_at

ตารางต่อไปนี้แสดงสิ่งที่โค้ดของคุณควรทำในแต่ละสถานะ

สถานะสิ่งที่โค้ดของคุณควรทำ
PENDINGรอต่อไป
IN_PROGRESSติดตาม progress: เปอร์เซ็นต์ของงานที่เสร็จสิ้นแล้ว ตั้งแต่ 0 ถึง 100
SUCCEEDEDดาวน์โหลดผลลัพธ์ Meshy เก็บไฟล์ไว้ในระยะเวลาจำกัด ดู การเก็บรักษาแอสเซ็ต
FAILEDอ่าน task_error จากนั้นแก้ไขอินพุตหรือสร้างทาสก์ใหม่ ดู ข้อผิดพลาด
CANCELEDหยุดรอ ทาสก์นี้จะไม่สร้างผลลัพธ์ มีเพียงทาสก์ของ Creative Lab เท่านั้นที่ใช้สถานะนี้

SUCCEEDED, FAILED และ CANCELED เป็นสถานะสุดท้าย เมื่อทาสก์ถึงสถานะใดสถานะหนึ่งเหล่านี้แล้ว สถานะจะไม่เปลี่ยนแปลงอีก

จากฝั่งโค้ดของคุณ จะเป็นลักษณะดังนี้

สร้างทาสก์ จากนั้นโพลจนกว่าจะเสร็จสิ้น

  1. คำขอ: POST/image-to-3d

  2. การตอบกลับ: 202{ "result": "<task_id>" }สร้างทาสก์แล้ว

  3. ทำซ้ำทุกสองสามวินาที

    1. คำขอ: GET/image-to-3d/<task_id>

    2. การตอบกลับ: 200{ "status": "IN_PROGRESS","progress": 45 }Retry-After: 5

  4. คำขอ: GET/image-to-3d/<task_id>

  5. การตอบกลับ: 200{ "status": "SUCCEEDED","model_urls": { "glb": "…" } }

หากแอปของคุณหยุดรอ ทาสก์จะยังคงทำงานต่อไป ให้ GET ภายหลังด้วยรหัสทาสก์เดียวกัน

เวลาในการประมวลผล

ตารางต่อไปนี้แสดงเวลามัธยฐานจากการใช้งาน API จริงบนระบบ production ในเดือนกันยายน 2026

เวลาจะนับตั้งแต่สร้างทาสก์จนถึงสถานะสุดท้าย เกือบทั้งหมดเป็นเวลาในการประมวลผล เนื่องจากทาสก์มักจะอยู่ในสถานะ PENDING เพียงไม่กี่วินาที เมื่อคิวมีงานหนาแน่น ทาสก์อาจต้องรอนานขึ้นก่อนจะเริ่มทำงาน และทาสก์ในแพลนที่มีลำดับความสำคัญสูงกว่ามักจะเริ่มทำงานได้เร็วกว่า

เวลาที่ต่ำกว่า 2 นาทีจะแสดงเป็นวินาที (s) และเวลาที่นานกว่านั้นจะแสดงเป็นนาที (min) คำว่าไม่รองรับหมายความว่า API ไม่มีตัวเลือกนั้นสำหรับโมเดลนั้น

ตัวเลขเหล่านี้เป็นเวลาทั่วไป ไม่ใช่เวลาที่รับประกันว่าจะเสร็จสมบูรณ์ ในช่วงเวลาที่มีงานหนาแน่น ทาสก์บางงานอาจใช้เวลานานกว่าแต่ก็ยังสำเร็จได้ หากต้องการตรวจสอบสถานะของ Meshy ดูหน้าแสดงสถานะ อย่าใช้เวลาเหล่านี้เป็นค่า timeout ในโค้ดของคุณ สำหรับค่า timeout ดู ควรรอนานแค่ไหน

การสร้างโมเดล 3 มิติ

APIการกำหนดค่าmeshy-7.1 (latest)meshy-6meshy-6-litemeshy-t2
ข้อความเป็น 3D (Preview)เฉพาะเมช75 s90 s45 s10 s
รูปภาพเป็น 3Dเฉพาะเมช75 s90 s40 s4 s
เมชพร้อมเท็กซ์เจอร์ 2K2 min3 min75 s60 s
เมชพร้อมเท็กซ์เจอร์ 4K2.5 min3.5 minไม่รองรับ80 s
เมชพร้อมเท็กซ์เจอร์ 8K3.5 min4 minไม่รองรับ2.5 min
หลายรูปเป็น 3Dเฉพาะเมช65 s2 min30 sไม่รองรับ
เมชพร้อมเท็กซ์เจอร์ 2K2.5 min3.5 min85 sไม่รองรับ
เมชพร้อมเท็กซ์เจอร์ 4K3 min4 minไม่รองรับไม่รองรับ
เมชพร้อมเท็กซ์เจอร์ 8K3.5 min4.5 minไม่รองรับไม่รองรับ

สำหรับรูปภาพเป็น 3D และหลายรูปเป็น 3D "เฉพาะเมช" หมายถึง should_texture: false ตัวเลือกและอินพุตต่อไปนี้ส่งผลต่อเวลา:

  • PBR แมป (enable_pbr) เพิ่มเวลา 30 ถึง 60 วินาที
  • จีออเมทรีระดับ ultra (geometry_resolution: "2k" หรือ "4k") เพิ่มเวลาสูงสุด 1 นาที
  • หากตั้งค่าเหมือนกัน รูปภาพอินพุตที่ซับซ้อนกว่าจะใช้เวลานานกว่า

การทำเท็กซ์เจอร์

APIความละเอียดเท็กซ์เจอร์เวลาโดยทั่วไป
ข้อความเป็น 3D (Refine)2K หรือ 4K80 s
8K3.5 min
รีเท็กซ์เจอร์2K55 s
4K90 s
8K2.5 min

การสร้างรูปภาพ

APInano-banananano-banana-2nano-banana-proโมเดล GPT Image
ข้อความเป็นรูปภาพ20 s15 s25 s20 ถึง 35 s
รูปภาพเป็นรูปภาพ40 s20 s30 s20 ถึง 40 s

Rigging และแอนิเมชัน

APIการกำหนดค่าเวลาโดยทั่วไป
Auto-Riggingrigging อัตโนมัติ40 s
แอนิเมชันต่อคำขอ15 s
ข้อความเป็นการเคลื่อนไหวmode prime15 s
mode swift10 s

การประมวลผลภายหลัง

APIเวลาโดยทั่วไป
รีเมช2 min
UV Unwrap35 s
แปลง7 s
ปรับขนาด15 s

การพิมพ์ 3 มิติ

APIการกำหนดค่าเวลาโดยทั่วไป
วิเคราะห์ความสามารถในการพิมพ์ตรวจสอบเมชเท่านั้น1 s
ตรวจสอบเมชและผนังบาง10 s
Multi-Colorต่อคำขอ30 s
ซ่อมความสามารถในการพิมพ์ซ่อมเมชเท่านั้น10 s
ตรวจสอบผนังบาง คงผนังไว้20 s
ตรวจสอบผนังบาง เพิ่มความหนาผนัง100 s
Auto Splitชิ้นส่วนสีพื้น70 s
ชิ้นส่วนมีเท็กซ์เจอร์ (keep_texture: true)170 s

ใน v2 ซ่อมความสามารถในการพิมพ์และวิเคราะห์ความสามารถในการพิมพ์จะรันการตรวจสอบผนังบางเสมอ ส่วนใน v1 จะรันการตรวจสอบนี้เมื่อคุณส่งประเภทเครื่องพิมพ์หรือขนาดการพิมพ์มา

ควรรอนานแค่ไหน

ทาสก์จะยังคงทำงานต่อไปแม้ว่าโค้ดของคุณจะหยุดรอ หากคำขอของคุณเกิด timeout การเชื่อมต่อของคุณหลุด หรือสตรีมของคุณปิดลง ทาสก์จะไม่ล้มเหลวและไม่ถูกยกเลิก

  • รออย่างน้อย 60 นาที นับจาก created_at ของทาสก์ ก่อนที่จะหยุดรอ หากคุณหยุดเร็วเกินไป คุณอาจพลาดทาสก์ที่สำเร็จในภายหลัง ซึ่งมักเกิดขึ้นในช่วงเวลาที่มีงานหนาแน่น
  • เก็บรหัสทาสก์ไว้ คุณสามารถดึงข้อมูลทาสก์ได้อีกครั้งทุกเมื่อ หากยังไม่ถึงสถานะสุดท้ายหลังจาก 60 นาที ให้ตรวจสอบอีกครั้งในภายหลัง หากยังคงเป็นเช่นนั้นต่อไป ให้ติดต่อฝ่ายสนับสนุน
  • มีเพียง FAILED เท่านั้นที่หมายความว่าทาสก์ล้มเหลว Meshy จะคืนเครดิตให้โดยอัตโนมัติสำหรับทาสก์ที่ล้มเหลว

ใช้ค่าเหล่านี้ในโค้ดของคุณ:

การตั้งค่าค่าที่แนะนำ
timeout ของคำขอสร้าง (POST)60 วินาที
timeout ของคำขอสร้าง (POST) ที่มีไฟล์ model_url ขนาดเกิน 100 MB120 วินาที Meshy จะดาวน์โหลดไฟล์ก่อนตอบกลับ
timeout ของคำขอสถานะ (GET)30 วินาที
ช่วงเวลาการโพลส่วนหัว Retry-After หรือ 5 วินาทีหากไม่มีส่วนหัวนี้ การโพลจะนับรวมในการจำกัดอัตราของคุณ
คำขอสถานะที่ล้มเหลว (timeout, 429 หรือ 5xx)ลองใหม่ในการโพลครั้งถัดไป ไม่ได้หมายความว่าทาสก์ล้มเหลว
เวลารอรวมต่อทาสก์อย่างน้อย 60 นาทีนับจาก created_at อย่านับเวลานี้ใหม่เมื่อคุณเชื่อมต่อสตรีมอีกครั้ง
สตรีมสตรีมอาจปิดลงก่อนที่ทาสก์จะเสร็จสิ้น หากปิดลงโดยไม่มีสถานะสุดท้าย ให้เชื่อมต่อใหม่หรือเปลี่ยนไปใช้การโพลแทน

สำหรับทาสก์จำนวนมากในคราวเดียว ให้ใช้ webhooks แทนการโพลแต่ละทาสก์ หากเหตุการณ์สุดท้ายของทาสก์ยังไม่มาถึงหลังจากผ่านไปประมาณสองเท่าของเวลาปกติ ให้ดึงทาสก์จากเอนด์พอยต์ GET ของมัน