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

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

ทำไมต้องมีขีดจำกัด

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

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

ขีดจำกัดทำงานอย่างไร

ขีดจำกัดอัตราวัดได้ 2 วิธี:

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

งานในคิวประกอบด้วย endpoint ข้อความเป็น 3D, รูปภาพเป็น 3D, ข้อความเป็นเท็กซ์เจอร์ และรีเมช endpoint อื่น ๆ เช่น Upload และยอดคงเหลือจะไม่รวมอยู่ในขีดจำกัดนี้

ขีดจำกัดจะถูกนำไปใช้ตามบัญชี ซึ่งหมายความว่าขีดจำกัดจะถูกแชร์ใน API key ทั้งหมดของคุณ

นอกจากขีดจำกัดอัตราแล้ว ลำดับความสำคัญในการประมวลผลงานยังส่งผลต่อความเร็วของงานของคุณด้วย

แต่ละระดับผู้ใช้มีขีดจำกัดอัตราและระดับลำดับความสำคัญเฉพาะที่ออกแบบมาให้ตรงกับความต้องการของตน นี่คือขีดจำกัดปัจจุบันตามระดับ:

ระดับผู้ใช้	คำขอต่อวินาที	งานในคิว	ระดับลำดับความสำคัญ
Pro	20	10	ค่าเริ่มต้น
Premium	20	30	สูงกว่า Pro
Ultra	20	100	สูงสุด
Studio	20	20	สูงกว่า Pro
Enterprise	100	ค่าเริ่มต้นคือ 50 สามารถปรับแต่งได้	สูงสุด

หากคุณเกินขีดจำกัดเหล่านี้ คุณจะได้รับการตอบกลับ 429 Too Many Requests จาก API ของเรา มีการเกินขีดจำกัดสองประเภทที่สามารถทำให้เกิดสิ่งนี้ โดยแต่ละประเภทมีการตอบกลับที่แตกต่างกัน:

การเกินขีดจำกัดคำขอ: สิ่งนี้เกิดขึ้นเมื่อคุณส่งคำขอต่อวินาทีมากเกินไป คุณจะได้รับการตอบกลับ 429 Too Many Requests พร้อมข้อความ RateLimitExceeded
การเกินขีดจำกัดคิว: สิ่งนี้เกิดขึ้นเมื่อคุณมีงานการสร้างพร้อมกันกำลังรันมากเกินไป คุณจะได้รับการตอบกลับ 429 Too Many Requests พร้อมข้อความ NoMoreConcurrentTasks