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 một 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 nhất định.

---

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

Chúng tôi đã đặt ra 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 tất cả 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à lành mạ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 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ữ cho mọi thứ vận hành trơn tru.

• Để đảm bảo mọi người đều nhận được phần công bằng của mình. Giống như chia sẻ đồ chơi trên sân chơi, chúng tôi muốn đảm bảo tất cả người dùng của mình 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 suất 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. Giống như đảm bảo một đườ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ắc nghẽn!

---

Giới hạn hoạt động như thế nào

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 sinh đồ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 là những tác vụ trên tài khoản của bạn đang ở trạng thái PENDING hoặc IN_PROGRESS. Mỗi endpoint tạo ra một tác vụ (ví dụ Văn bản sang 3D, Ảnh sang 3D, Nhiều ảnh sang 3D, Tạo lại texture, Remesh, Rigging, Hoạt hình, Văn bản sang ảnh, các endpoint in 3D và Creative Lab) đều kiểm tra giới hạn này trước khi chấp nhận một tác vụ mới. Các yêu cầu không tạo ra tác vụ, chẳng hạn như Số dư, Mức sử dụng, và việc truy xuất, liệt kê hoặc truyền trực tuyến các tác vụ, không được tính vào giới hạn này, mặc dù chúng vẫn được tính vào số yêu cầu mỗi giây.

Các giới hạn được áp dụng theo từng tài khoản, vì vậy chúng được chia sẻ trên tất cả API key của bạn và Playground. Các tác vụ bạn khởi chạy trong ứng dụng web Meshy cũng được tính vào tác vụ trong hàng đợi của bạn.

Bên cạnh 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 từng cấp:

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 va chạm có thể kích hoạt điều này, mỗi loại có phản hồi khác nhau:

• Va chạm 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 Rate limit exceeded.
• Va chạm hàng đợi: Đ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 với thông báo NoMorePendingTasks (hoặc, khi tín dụng của bạn hết, NoMoreConcurrentTasks). 429 này không có Retry-After: hãy chờ một trong các tác vụ của bạn hoàn thành trước khi tạo tác vụ khác.

---

Tiêu đề giới hạn tốc độ

Các phản hồi API đi kèm với những tiêu đề này để bạn có thể điều tiết nhịp độ các yêu cầu của mình:

Khi Retry-After xuất hiện, hãy chờ đúng số giây đó trước khi gửi yêu cầu tiếp theo.