Tài liệu API · Độ tin cậy
Giới hạn tốc độ
RPM, số tác vụ đồng thời và các header giới hạn tốc độ.
RPM được tính theo Key với cửa sổ cố định 60 giây; giới hạn là giá trị nhỏ hơn giữa RPM của Key và RPM của tài khoản, các Key trong cùng một tài khoản được đếm riêng. Khi vượt quá, API trả về 429 rate_limited. Mọi yêu cầu đã qua xác thực đều có các header phản hồi sau:
| Header phản hồi | Ý nghĩa |
|---|---|
X-RateLimit-Limit | Số yêu cầu được phép trong cửa sổ hiện tại |
X-RateLimit-Remaining | Số yêu cầu còn lại trong cửa sổ hiện tại |
X-RateLimit-Reset | Thời điểm cửa sổ được đặt lại (giây unix) |
Retry-After | Chỉ có khi trả về 429, số giây nên chờ (bằng 10 khi vượt giới hạn đồng thời) |
Số tác vụ chạy đồng thời bị giới hạn bởi cả giới hạn đồng thời của Key và của tài khoản. Bạn có thể đặt RPM và giới hạn đồng thời riêng cho từng Key trong bảng điều khiển; nếu cần giới hạn tài khoản cao hơn, hãy liên hệ đội ngũ vận hành.
Phản hồi 429
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1730259012
{ "error": { "code": "rate_limited", "retryable": true, ... } }