# Hạn mức và cách chọn nguồn

> Hạn mức tháng tính bằng USD cho từng khoá, thành viên và khách hàng; ba chế độ chọn nguồn AI; và điều gì xảy ra khi một hạn mức chạm trần.

Source: https://kongapiai.com/docs/limits

## Hạn mức hoạt động thế nào

Hạn mức tính theo tháng, bằng USD, và được đặt lại vào ngày 1 hằng tháng theo giờ UTC.

Bạn đặt được hạn mức ở nhiều tầng:

| Tầng | Giới hạn cái gì |
| --- | --- |
| Khoá | Mức dùng của một khoá |
| Thành viên | Tổng mức dùng của mọi khoá thuộc về một người |
| Khách hàng | Tổng mức dùng được tính cho một khách hàng của bạn |
| Số dư | Tổng số dư còn lại của cả không gian làm việc |

Một yêu cầu dừng ở hạn mức đầu tiên nó chạm tới. API trả về số `402` kèm mã cho biết hạn mức nào đã hết, ví dụ `key_limit` hoặc `budget_exceeded`.

> Trước khi chạy, mỗi yêu cầu giữ trước một khoản bằng mức tối đa nó có thể tốn. Nếu số dư khả dụng không đủ cho khoản giữ này, yêu cầu bị từ chối với mã `insufficient_budget`. Chạy xong, phần không dùng được trả lại.

## Hạn mức tính trên cái gì

Hạn mức chỉ tính phần trả bằng số dư KONG API AI. Yêu cầu chạy bằng nguồn AI riêng của bạn không bị giới hạn bởi hạn mức này; giới hạn của chúng là hạn ngạch mà nhà cung cấp đặt cho tài khoản của bạn.

## Ba chế độ chọn nguồn

Mỗi khoá chạy ở một trong ba chế độ:

| Chế độ | Yêu cầu chạy ở đâu | KONG API AI tính phí token |
| --- | --- | --- |
| Tự động | Nguồn riêng của bạn trước. Chỉ dùng số dư nếu bạn bật dự phòng | Chỉ khi dùng tới số dư |
| Số dư | Luôn trả bằng số dư, theo giá qua KONG API AI | Có |
| Nguồn riêng | Chỉ dùng nguồn của bạn | Không |

Ở chế độ Tự động, nếu không nguồn riêng nào xử lý được và dự phòng đang tắt, API trả về số `429` với mã `own_quota_unavailable`.

## Khi hạn mức hết

- Tăng hạn mức của khoá, thành viên hoặc khách hàng trong console.
- Hoặc nạp thêm số dư.
- Yêu cầu tiếp theo sẽ chạy bình thường. Không cần tạo khoá mới.

## Tạm dừng mọi khoá

Quản trị viên có thể tạm dừng mọi khoá của không gian làm việc trong trang Thanh toán. Khi đó API trả về số `503` với mã `workspace_paused`.
