Xử lý model không tồn tại, giới hạn tốc độ và dịch vụ bận
404 Model Not Found（mô hình không tồn tại）
| Nguyên nhân | Cách xử lý |
|---|---|
| Viết sai tên mô hình | Lấy danh sách mô hình của nhóm trên trang này làm chuẩn, đừng sao chép của nền tảng khác |
| Nhóm của key không chứa mô hình đó | Đổi nhóm hoặc đổi mô hình |
Base URL thiếu /v1 | Thêm vào, ví dụ https://kuaiapi.net/v1 |
| Kênh đã gỡ mô hình đó | Xem thông báo, đổi sang mô hình thay thế |
429 Too Many Requests（giới hạn tốc độ）
429 không nhất thiết là 「giới hạn tốc độ」, hãy kiểm tra lần lượt theo thứ tự:
- Số dư/hạn mức không đủ → xem trước tiên Số dư không đủ
- Tần suất yêu cầu vượt giới hạn → giảm đồng thời/tần suất, thử lại sau
- Đồng thời cấp tài khoản đã đầy → chờ các yêu cầu đang chạy kết thúc
- Hạn mức kênh đã cạn → đổi khung giờ rồi thử lại hoặc liên hệ support（support@kuaiapi.net）
TIP
Đừng chỉ coi 429 là 「giới hạn tốc độ」: số dư không đủ, quyền lợi gói cạn, hạn mức mô hình dùng hết đều trả về 429.
5xx Service Busy（dịch vụ bận）
- Dịch vụ mô hình của kênh dao động, mạng chập chờn, tải quá cao
- Xử lý: thử lại theo cơ chế exponential backoff（1s、2s、4s…）, đừng gửi dồn dập khi báo lỗi
- Chỉ xuất hiện ở một endpoint → đổi sang endpoint được đề xuất
- Thất bại liên tục → cung cấp thời gian, mô hình, request ID cho support（support@kuaiapi.net）
Ba việc giúp giảm lỗi
- Giảm đồng thời: kiểm soát số lượng đồng thời cho tác vụ dài/hàng loạt
- Dùng đúng mô hình: tên mô hình dùng đúng theo danh sách nhóm
- Xem thông báo: trước khi kênh bảo trì/tăng giá/gỡ bỏ, admin thường sẽ thông báo