Giới hạn tốc độ

Giới hạn tốc độ là những hạn chế mà API của chúng tôi áp đặt lên số lần người dùng hoặc khách hàng có thể truy cập dịch vụ của chúng tôi trong một khoảng thời gian nhất định.

Tại sao có giới hạn

Chúng tôi đã đặt ra các giới hạn tốc độ trên API của mình để giúp tạo ra trải nghiệm tốt nhất cho mọi người. Đây là lý do tại sao chúng quan trọng:

Để giữ cho dịch vụ của chúng tôi an toàn và ổn định! Hãy nghĩ về giới hạn tốc độ như những người bảo vệ thân thiện - họ đảm bảo không ai có thể làm quá tải API của chúng tôi với quá nhiều yêu cầu cùng một lúc. Điều này giúp bảo vệ dịch vụ của chúng tôi khỏi việc sử dụng sai mục đích và giữ cho mọi thứ hoạt động trơn tru.
Để đảm bảo mọi người đều có phần công bằng. Giống như chia sẻ đồ chơi trong sân chơi, chúng tôi muốn đảm bảo tất cả người dùng của chúng tôi có quyền truy cập bình đẳng vào API. Bằng cách nhẹ nhàng giới hạn số lượng yêu cầu mà mỗi người dùng có thể thực hiện, chúng tôi đảm bảo không ai phải chờ đợi quá lâu cho lượt của mình.
Để giữ cho hiệu suất nhanh chóng và đáng tin cậy. Bằng cách quản lý luồng yêu cầu tổng thể, chúng tôi có thể duy trì thời gian phản hồi nhanh và dịch vụ ổn định cho tất cả người dùng tuyệt vời của chúng tôi. Nó giống như đảm bảo một con đường cao tốc không bị quá tải - giao thông lưu thông tốt hơn khi chúng tôi ngăn chặn tắc nghẽn!

Cách hoạt động của giới hạn

Giới hạn tốc độ được đo lường theo 2 cách:

Yêu cầu mỗi giây: Đây là số lượng yêu cầu mạng bạn có thể thực hiện mỗi giây.
Tác vụ trong hàng đợi: Đây là số lượng tác vụ tạo đồng thời bạn có thể chạy trong hàng đợi tại bất kỳ thời điểm nào.

Tác vụ trong hàng đợi bao gồm các endpoint Văn bản sang 3D, Ảnh sang 3D, Văn bản sang texture, và Remesh. Các endpoint khác như Tải lên và Balance không được bao gồm trong giới hạn này.

Các giới hạn được áp dụng trên cơ sở từng tài khoản. Điều này có nghĩa là các giới hạn được chia sẻ trên tất cả các API key của bạn.

Ngoài giới hạn tốc độ, độ ưu tiên xử lý tác vụ cũng sẽ ảnh hưởng đến tốc độ của các tác vụ của bạn.

Mỗi cấp người dùng có các giới hạn tốc độ và mức độ ưu tiên cụ thể được thiết kế để phù hợp với nhu cầu của họ. Dưới đây là các giới hạn hiện tại theo cấp:

Cấp người dùng	Yêu cầu mỗi giây	Tác vụ trong hàng đợi	Mức độ ưu tiên
Pro	20	10	Mặc định
Premium	20	30	Cao hơn Pro
Ultra	20	100	Cao nhất
Studio	20	20	Cao hơn Pro
Enterprise	100	Mặc định là 50, có thể tùy chỉnh	Cao nhất

Nếu bạn vượt quá các giới hạn này, bạn sẽ nhận được phản hồi 429 Too Many Requests từ API của chúng tôi. Có hai loại hit có thể kích hoạt điều này, mỗi loại có một phản hồi khác nhau:

Request Hit: Điều này xảy ra khi bạn thực hiện quá nhiều yêu cầu mỗi giây. Bạn sẽ nhận được phản hồi 429 Too Many Requests với thông báo RateLimitExceeded.
Queue Hit: Điều này xảy ra khi bạn có quá nhiều tác vụ tạo đồng thời đang chạy. Bạn sẽ nhận được phản hồi 429 Too Many Requests với thông báo NoMoreConcurrentTasks.