Giới hạn tốc độ

Kiểm tra số lượng yêu cầu và tác vụ mà gói của bạn cho phép, và những việc cần làm khi bạn đạt đến giới hạn.

Giới hạn theo gói

Để giữ cho API luôn nhanh và sẵn sàng cho mọi người, Meshy giới hạn mỗi tài khoản theo hai cách:

Yêu cầu mỗi giây: số lượng yêu cầu API bạn có thể gửi mỗi giây.
Tác vụ đồng thời: số lượng tác vụ của bạn có thể ở trạng thái PENDING hoặc IN_PROGRESS cùng lúc.

Giới hạn phụ thuộc vào gói của bạn:

Gói	Yêu cầu mỗi giây	Tác vụ đồng thời	Độ ưu tiên
Pro	20	10	Mặc định
Premium	20	30	Cao hơn Pro
Ultra	20	100	Cao nhất
Studio	20	60, hoặc 20 với một số gói Studio trước đây	Cao hơn Pro
Enterprise	100	100 theo mặc định, hoặc giới hạn tùy chỉnh	Cao nhất

Độ ưu tiên không phải là một giới hạn. Khi hàng đợi bận, Meshy sẽ bắt đầu các tác vụ có độ ưu tiên cao hơn trước.

Những gì được tính vào mỗi giới hạn

Mọi yêu cầu API đều được tính vào yêu cầu mỗi giây, bao gồm cả các yêu cầu lấy, liệt kê hoặc stream tác vụ. Các yêu cầu từ ứng dụng web Meshy không được tính.

Giới hạn tác vụ đồng thời tính theo tác vụ, không phải yêu cầu. Mọi endpoint tạo ra một tác vụ đều kiểm tra giới hạn này trước khi tạo 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.

Các yêu cầu không tạo ra tác vụ thì không được tính vào giới hạn này. Ví dụ: Số dư, Mức sử dụng, và các yêu cầu lấy, liệt kê hoặc stream tác vụ không được tính.

Giới hạn của ai được áp dụng

Bảng sau đây cho biết giới hạn của ai mà khóa API, Playground, và ứng dụng web của bạn được tính vào:

Nơi bạn làm việc	Tài khoản cá nhân	Nhóm
Khóa API	Giới hạn của bạn	Giới hạn của nhóm, được chia sẻ bởi mọi khóa API trong nhóm
Playground	Giới hạn của bạn	Giới hạn của chính bạn với tư cách là thành viên đã đăng nhập
Ứng dụng web	Tác vụ đồng thời của bạn	Tác vụ đồng thời của chính bạn. Các tác vụ mà chủ sở hữu nhóm bắt đầu cũng được tính vào giới hạn của nhóm.

Khi bạn đạt đến giới hạn

Khi bạn vượt quá giới hạn, API sẽ trả về 429 Too Many Requests. Thông báo sẽ cho bạn biết bạn đã đạt đến giới hạn nào:

Quá nhiều yêu cầu mỗi giây: thông báo là Rate limit exceeded. Chờ số giây được ghi trong header Retry-After, sau đó thử lại.
Quá nhiều tác vụ đồng thời: thông báo bắt đầu bằng NoMorePendingTasks. Với gói không giới hạn nhưng không còn tín dụng, thông báo bắt đầu bằng NoMoreConcurrentTasks. Lỗi 429 này không có header Retry-After. Hãy chờ một trong các tác vụ của bạn hoàn thành, sau đó mới tạo tác vụ tiếp theo.

Header giới hạn tốc độ

Các phản hồi API bao gồm những header sau để giúp bạn điều tiết các yêu cầu:

Header	Mô tả
`X-RateLimit-Limit`	Số yêu cầu được phép mỗi giây theo gói của bạn.
`X-RateLimit-Remaining`	Số yêu cầu còn lại trong giây hiện tại.
`X-RateLimit-Reset`	Số giây cho đến khi hạn mức của bạn đầy trở lại.
`Retry-After`	Số giây cần chờ trước khi gửi yêu cầu tiếp theo. Được gửi kèm lỗi `429` khi quá nhiều yêu cầu mỗi giây, và khi bạn lấy một tác vụ vẫn đang ở trạng thái `PENDING` hoặc `IN_PROGRESS`.

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