การจำกัดอัตรา

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

---

ขีดจำกัดตามแพ็กเกจ

เพื่อให้ API ทำงานได้รวดเร็วและพร้อมใช้งานสำหรับทุกคน Meshy จำกัดแต่ละบัญชีไว้สองด้าน:

• คำขอต่อวินาที: จำนวนคำขอ API ที่คุณสามารถส่งได้ในแต่ละวินาที
• งานที่ทำพร้อมกัน: จำนวนงานของคุณที่สามารถอยู่ในสถานะ PENDING หรือ IN_PROGRESS ได้ในเวลาเดียวกัน

ขีดจำกัดจะขึ้นอยู่กับแพ็กเกจของคุณ:

ลำดับความสำคัญไม่ใช่ขีดจำกัด เมื่อคิวมีงานหนาแน่น Meshy จะเริ่มงานที่มีลำดับความสำคัญสูงกว่าก่อน

สิ่งที่นับรวมในแต่ละขีดจำกัด

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

ขีดจำกัดงานที่ทำพร้อมกันจะนับจากจำนวนงาน ไม่ใช่จำนวนคำขอ ทุกเอนด์พอยต์ที่สร้างงานจะตรวจสอบขีดจำกัดนี้ก่อนสร้างงานใหม่ ตัวอย่างเช่น ข้อความเป็น 3D, รูปภาพเป็น 3D, หลายรูปเป็น 3D, รีเท็กซ์เจอร์, รีเมช, Rigging, แอนิเมชัน, ข้อความเป็นรูปภาพ, เอนด์พอยต์การพิมพ์ 3 มิติ และ Creative Lab จะตรวจสอบขีดจำกัดนี้

คำขอที่ไม่ได้สร้างงานจะไม่ถูกนับรวม เช่น ยอดคงเหลือ, การใช้งาน และคำขอที่ใช้ดึงข้อมูล แสดงรายการ หรือสตรีมงาน จะไม่ถูกนับ

ขีดจำกัดของใครที่มีผล

ตารางต่อไปนี้แสดงว่า API คีย์, Playground และเว็บแอปของคุณนับรวมในขีดจำกัดของใคร:

---

เมื่อคุณถึงขีดจำกัด

เมื่อคุณเกินขีดจำกัด API จะส่งค่ากลับเป็น 429 Too Many Requests ข้อความจะบอกคุณว่าคุณถึงขีดจำกัดใด:

• คำขอต่อวินาทีมากเกินไป: ข้อความจะเป็น Rate limit exceeded ให้รอตามจำนวนวินาทีในส่วนหัว Retry-After แล้วลองใหม่
• งานที่ทำพร้อมกันมากเกินไป: ข้อความจะขึ้นต้นด้วย NoMorePendingTasks สำหรับแพ็กเกจแบบไม่จำกัดที่ไม่มีเครดิตเหลือแล้ว ข้อความจะขึ้นต้นด้วย NoMoreConcurrentTasks ค่า 429 นี้จะไม่มีส่วนหัว Retry-After ให้รอจนกว่างานใดงานหนึ่งของคุณจะเสร็จสิ้น แล้วจึงสร้างงานถัดไป

---

Rate limit headers

การตอบกลับของ API จะมีส่วนหัวเหล่านี้เพื่อช่วยคุณจัดจังหวะคำขอ:

เมื่อมี Retry-After อยู่ ให้รอตามจำนวนวินาทีนั้นก่อนส่งคำขอครั้งถัดไป