Giới hạn & rate limit

Để công bằng và ổn định cho mọi người, mỗi tài khoản có 3 lớp giới hạn. Bạn xem mức đang dùng ngay ở Tổng quan (thanh “Lượt dùng hôm nay” + dòng “Giới hạn”).

Loại	Mức	Khi vượt
Lượt / ngày	1.200 lượt/ngày	HTTP 429 · `DAILY_REQUEST_LIMIT_EXCEEDED` Reset lúc 00:00 (giờ VN). Đủ cho dùng cá nhân/agent bình thường (đa số user ~50 lượt/ngày).
Tốc độ (RPM)	60 lượt / phút	HTTP 429 · `RATE_LIMIT_RPM` Chống gửi dồn dập. Chờ ~1 phút là gửi lại được.
Song song	3 tác vụ cùng lúc	HTTP 429 · `CONCURRENCY_LIMIT_EXCEEDED` Request thứ 4 tự xếp hàng chờ ~60s để có slot; nếu vẫn kín thì mới báo lỗi.

429 nghĩa là gì?

Khi chạm giới hạn, API trả HTTP 429 kèm error.code cho biết chạm lớp nào (ngày / phút / song song). Cách xử lý: chờ rồi thử lại (backoff) — hầu hết client/agent (Claude Code, Cline, OpenAI SDK) tự retry. Đây không phải hết credits (402).

Streaming

Gửi "stream": true để nhận response dạng SSE (server-sent events) — từng chunk giống hệt định dạng OpenAI, kết thúc bằng data: [DONE]. Model trong response luôn là nexai (cổng tự chọn nguồn tốt nhất cho mỗi request). Một request streaming có thể mở kết nối tới vài phút; tính là 1 tác vụ song song tới khi xong.

Các con số trên là mặc định — admin có thể nâng giới hạn riêng cho tài khoản của bạn nếu cần.