Giới hạn tần suất

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

Vì sao có giới hạn

Chúng tôi đã đặt ra các giới hạn tần suất cho API của mình nhằm mang lại trải nghiệm tốt nhất cho tất cả mọi người. Dưới đây là lý do vì 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 hình dung giới hạn tần suất như những người gác cổng 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 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ụ khỏi nguy cơ bị lạm dụng và giữ cho mọi thứ vận hành trơn tru.
Để đảm bảo mọi người đều được chia sẻ công bằng. Cũ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 đều 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 đến lượt mình.
Để giữ hiệu năng luôn 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ư việc đảm bảo một tuyến đường cao tốc không bị quá đông đúc - giao thông sẽ lưu thông tốt hơn khi chúng ta ngăn chặn tình trạng ùn tắc!

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

Giới hạn tần suất đượ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 sinh đồng thời mà 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ư 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ẻ giữa tất cả các API key của bạn.

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

Mỗi cấp người dùng có giới hạn tần suất 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 từng 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à 100, 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 vi phạm 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 kèm 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 sinh đồng thời đang chạy. Bạn sẽ nhận được phản hồi 429 Too Many Requests kèm thông báo NoMoreConcurrentTasks.