KONG API AI Tài liệu Bắt đầu miễn phí

Dùng khoá

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.

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ầngGiới hạn cái gì
KhoáMức dùng của một khoá
Thành viênTổng mức dùng của mọi khoá thuộc về một người
Khách hàngTổ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.

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 ở đâuKONG API AI tính phí token
Tự độngNguồn riêng của bạn trước. Chỉ dùng số dư nếu bạn bật dự phòngChỉ khi dùng tới số dư
Số dưLuôn trả bằng số dư, theo giá qua KONG API AICó
Nguồn riêngChỉ dùng nguồn của bạnKhô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.