Giới hạn tốc độ

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

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

Chúng tôi đã áp dụng giới hạn tốc độ cho 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 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 gác cửa thân thiện - chúng đảm bảo không ai có thể làm quá tải API của chúng tôi bằng quá nhiều yêu cầu cùng lúc. Điều này giúp bảo vệ dịch vụ của chúng tôi khỏi khả năng bị lạm dụng và giữ mọi thứ vận hành trơn tru.
Để đảm bảo mọi người đều có phần công bằng của mình. 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 đều có quyền truy cập API như nhau. Bằng cách giới hạn nhẹ nhàng 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ờ quá lâu đến lượt mình.
Để giữ hiệu năng nhanh nhạy 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 mình. Điều này giống như đảm bảo một tuyến cao tốc không trở nên quá đông đúc - giao thông sẽ lưu thông tốt hơn khi chúng ta ngăn ngừa tắc nghẽn!

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

Giới hạn tốc độ được đo 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.

Các 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ư Upload và Balance không được tính vào giới hạn này.

Các giới hạn được áp dụng theo 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ả 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 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 trường hợp chạm giới hạn có thể kích hoạt điều này, mỗi loại có một phản hồi khác nhau:

Chạm giới hạn yêu cầu: Đ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.
Chạm giới hạn hàng đợi: Đ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.