Khóa API và hạn mức

​

Tạo khóa API

• Khóa có dạng sk- kèm 32 ký tự ngẫu nhiên, ví dụ sk-9Kd2xQ….
• Danh sách khóa hiển thị 12 ký tự đầu để bạn nhận ra khóa nào là khóa nào.
• Khóa hành động với quyền của người đã tạo ra nó, nên không cấp thêm quyền gì mới.

​

Thu hồi và xoay vòng khóa

​

Xem hạn mức đã dùng

GET https://agents.fpt.ai/direct-bff/v1/usage
Authorization: Bearer <khóa API của tổ chức>

{
  "day": "2026-09-14",
  "runs": { "used": 42, "limit": 2000, "remaining": 1958, "resetsAt": "2026-09-15T00:00:00Z" },
  "rate": { "limit": 20, "window": "1m" }
}

• runs là ngân sách theo ngày UTC của cả tổ chức, dùng chung cho mọi hội thoại và mọi kênh, về lại mức đầy lúc 00:00 UTC.
• rate.limit là hạn mức theo phút cho mỗi bên gọi.
• Xem hạn mức không tốn hạn mức, nên bạn có thể gọi thường xuyên.
• Chỉ khóa API gọi được; visitorToken bị từ chối với 403 USAGE_FORBIDDEN.

X-RateLimit-Limit: 2000
X-RateLimit-Remaining: 1957
X-RateLimit-Reset: 1757894400