ข้ามไปยังเนื้อหาหลัก

วิธีแก้ไขข้อผิดพลาด 429 และ Rate Limit ของ Meshy API

Rate Limits ของ Meshy API: แก้ไขข้อผิดพลาด 429

สารบัญ

หาก integration ของคุณกำลังเจอข้อผิดพลาด 429, RateLimitExceeded หรือ NoMoreConcurrentTasks เมื่อเรียกใช้ Meshy API คู่มือนี้จะอธิบายว่าทำไมข้อจำกัดเหล่านี้ถึงมีอยู่ และวิธีออกแบบ integration ของคุณให้ทำงานภายในข้อจำกัดเหล่านี้

ทำไม rate limits ถึงมีอยู่

Meshy API ทำงานบน GPU compute ที่ใช้ร่วมกันซึ่งใช้ในการสร้างโมเดล 3D, texture และ asset ที่เกี่ยวข้อง Rate limits และ concurrency caps ช่วยปกป้อง infrastructure ที่ใช้ร่วมกันนี้ เพื่อให้คุณภาพของ generation และเวลาตอบสนองยังคงสม่ำเสมอสำหรับทุกผู้ใช้บนแพลตฟอร์ม ทุกบัญชีจะมีจำนวน request สูงสุดที่สามารถส่งได้ในช่วงเวลาที่กำหนด และจำนวนงาน generation สูงสุดที่สามารถทำงานพร้อมกัน (อยู่ในคิวหรือกำลังดำเนินการ) ตามแผนที่ใช้อยู่

Request limit เทียบกับ queue/concurrency limit

มีขีดจำกัดสองประเภทที่แตกต่างกัน และเกิดความล้มเหลวต่างกัน:

  • Request rate limit (429 / RateLimitExceeded): จำกัดจำนวนการเรียก API (เช่น การสร้างงาน การ polling สถานะ) ที่คุณสามารถทำได้ต่อนาที การเกินขีดจำกัดหมายความว่าคุณเรียก API บ่อยเกินไป โดยไม่ขึ้นกับจำนวนงานที่กำลังทำงานจริง

  • Concurrency / queue limit (NoMoreConcurrentTasks): จำกัดจำนวนงาน generation ที่คุณสามารถมีอยู่ในคิวหรือกำลังประมวลผลพร้อมกัน การเกินขีดจำกัดหมายความว่าคุณมีงานที่ active ถึงจำนวนสูงสุดแล้ว และต้องรอให้งานหนึ่งเสร็จก่อนจึงจะส่งงานใหม่ได้

ตรวจสอบ request และ concurrency limits ปัจจุบันของแผนคุณได้ในแดชบอร์ด Meshy เนื่องจากค่าเหล่านี้แตกต่างกันได้ตามระดับแผน

กลยุทธ์ Backoff สำหรับข้อผิดพลาด 429

เมื่อคุณได้รับการตอบกลับ 429 หรือ RateLimitExceeded อย่าลองส่งคำขอเดิมซ้ำทันที ให้ทำดังนี้แทน:

  • ใช้ exponential backoff: รอช่วงเวลาสั้นๆ ก่อน แล้วเพิ่มเป็นสองเท่าทุกครั้งที่ล้มเหลว ไปจนถึงค่าสูงสุดที่สมเหตุสมผล

  • เพิ่ม jitter (ค่าสุ่มขนาดเล็ก) ให้กับช่วง backoff ของคุณ เพื่อไม่ให้ worker หลายตัวในระบบของคุณลองส่งคำขอซ้ำในเวลาเดียวกันทั้งหมด

  • ให้ความสำคัญกับ Retry-After หรือ rate-limit headers ที่ส่งกลับมาในการตอบกลับ หากมี แทนที่จะคาดเดาเวลารอ

  • จำกัดจำนวนครั้งในการลองใหม่ต่อคำขอ เพื่อไม่ให้ความล้มเหลวที่ยั่งยืนวนซ้ำไม่สิ้นสุด

การวางแผนรอบ concurrency limits

ข้อผิดพลาด NoMoreConcurrentTasks หมายความว่าคุณถึงเพดานของ tasks ที่กำลังทำงานอยู่ของบัญชีแล้ว เพื่อหลีกเลี่ยงการเจอข้อผิดพลาดนี้ใน production:

  • สร้าง local queue หรือ job scheduler ในแอปพลิเคชันของคุณเองที่จะส่ง generation task ใหม่ก็ต่อเมื่อ task ก่อนหน้าเสร็จสิ้น หรือจำนวน task ที่กำลังทำงานอยู่ลดลงต่ำกว่า limit

  • Poll task status (หรือใช้ webhooks หากรองรับใน workflow ของคุณ) เพื่อทราบเมื่อ slot ว่างลง แทนที่จะส่ง request โดยไม่แน่ใจ

  • จัดกลุ่มและควบคุม bulk generation jobs แทนที่จะส่ง request ทั้งหมดพร้อมกัน — วิธีนี้จะช่วยให้ทั้ง request rate และจำนวน concurrent task เรียบเนียนขึ้น

  • สร้าง monitoring/alerting ฝั่งของคุณเองเพื่อให้ spike ของข้อผิดพลาด 429/NoMoreConcurrentTasks มองเห็นได้ก่อนที่จะส่งผลกระทบต่อผู้ใช้ของคุณ

การลองใหม่สำหรับ generations ที่ล้มเหลวหรือไม่เป็นที่พอใจ

Meshy API ปัจจุบันไม่รองรับการ "ลองใหม่" ในตัวสำหรับ generation ที่มีอยู่แล้วสำหรับแผน individual หรือ studio — หากผลลัพธ์ไม่เป็นไปตามที่คาดหวัง คุณต้องส่งคำขอ generation ใหม่ ซึ่งจะใช้ credits ตามปกติ เมื่อ automated pipeline ของคุณจัดการกับข้อผิดพลาดชั่วคราว (เช่น 429) ตรวจสอบให้แน่ใจว่า retry logic ของคุณส่งคำขอเดิมซ้ำหลังจาก backing off เท่านั้น ไม่ใช่สร้าง generation tasks ที่ซ้ำกันทุกครั้ง

เมื่อไหร่ควรพิจารณาอัพเกรดแผนของคุณ

หากคุณได้ implement กลยุทธ์ backoff และการจัดคิวที่รู้จัก concurrency แล้ว แต่ยังคงเจอ rate หรือ concurrency limits อยู่เสมอ นั่นมักเป็นสัญญาณว่า throughput ที่ integration ของคุณต้องการได้เติบโตเกินกว่าขีดจำกัดของแผนปัจจุบันแล้ว ตรวจสอบ dashboard ของคุณสำหรับ request และ concurrency allowances ของแผนปัจจุบัน และพิจารณาอัพเกรด หรือติดต่อทีมขายของ Meshy เกี่ยวกับ enterprise-level API access หากคุณต้องการ throughput ที่สูงขึ้นอย่างต่อเนื่อง

คำถามที่พบบ่อย

1. ข้อผิดพลาด 429 หรือ RateLimitExceeded หมายความว่าอย่างไร?

หมายความว่าคุณได้เกินจำนวน API requests ที่อนุญาตภายในช่วงเวลาที่กำหนดสำหรับแผนของคุณแล้ว ลดอัตราการส่ง request ลงและใช้ exponential backoff ก่อนลองใหม่

2. NoMoreConcurrentTasks หมายความว่าอย่างไร?

หมายความว่าคุณมีจำนวน generation tasks สูงสุดที่อยู่ในคิวหรือกำลังดำเนินการสำหรับบัญชีของคุณแล้ว รอให้งานที่กำลังทำเสร็จก่อน หรือลดจำนวนงานที่คุณส่งพร้อมกัน ก่อนจะส่งงานเพิ่ม

3. ฉันจะทราบ rate และ concurrency limits ของบัญชีได้อย่างไร?

ตรวจสอบ Meshy dashboard ของคุณสำหรับ limits ที่เกี่ยวข้องกับแผนปัจจุบัน เนื่องจาก limits เหล่านี้อาจแตกต่างกันระหว่างระดับแผน

4. Meshy รองรับการลองใหม่อัตโนมัติสำหรับ generation tasks หรือไม่?

ไม่ ไม่สำหรับแผน individual หรือ studio — generation ที่ล้มเหลวหรือไม่เป็นที่พอใจต้องส่งใหม่เป็น request ใหม่ ซึ่งใช้ credits ตามปกติ ลูกค้า Enterprise ควรติดต่อฝ่ายขายเกี่ยวกับฟังก์ชันการลองใหม่

5. วิธีที่ดีที่สุดในการหลีกเลี่ยงข้อผิดพลาดเหล่านี้ใน production pipeline คืออะไร?

ใช้งาน local queue ที่ควบคุมการส่งให้อยู่ภายใน concurrency limit ของคุณ เพิ่ม exponential backoff พร้อม jitter สำหรับ 429 responses ใดๆ และตรวจสอบ error rates เพื่อให้คุณสามารถตอบสนองได้ก่อนที่จะส่งผลกระทบต่อผู้ใช้ของคุณ

6. ฉันควรอัพเกรดแผนเมื่อไหร่เพราะ rate limits?

หากคุณได้ใช้งาน backoff และ concurrency-aware queuing แล้วและยังคงเจอ limits เหล่านี้เป็นประจำ การใช้งานของคุณอาจเติบโตเกินกว่าแผนปัจจุบัน — ตรวจสอบ dashboard ของคุณหรือติดต่อฝ่ายขายเกี่ยวกับแผนที่มี throughput สูงกว่า


บทความที่เกี่ยวข้อง

คำตอบนี้ช่วยตอบคำถามของคุณหรือไม่