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

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

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

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

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

การทำงานของการจำกัด

การจำกัดอัตราถูกวัดใน 2 วิธี:

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

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

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

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

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

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

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

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