Truy vấn sử dụng token

Nó làm gì

Truy xuất mức sử dụng hạn ngạch của mã thông báo Bearer hiện tại: tổng số được cấp, đã sử dụng, có sẵn, cờ không giới hạn, giới hạn mô hình và thời gian hết hạn.

📮 Điểm cuối

GET /api/usage/token

Yêu cầu tiêu đề ủy quyền
Trả về thông tin sử dụng cho mã thông báo được sử dụng trong yêu cầu hiện tại

🔐 Xác thực

Bao gồm tiêu đề sau để xác thực khóa API:

Authorization: Bearer $API_KEY

Tiền tố sk- được chấp nhận nhưng không bắt buộc; máy chủ bình thường hóa nó
Tiêu đề ủy quyền bị thiếu hoặc không hợp lệ trả về 401

💡 Yêu cầu Ví dụ

curl -X GET https://88api.ai/api/usage/token \
  -H "Authorization: Bearer $API_KEY"

✅ Ví dụ về phản hồi thành công

{
  "code": true,
  "message": "ok",
  "data": {
    "object": "token_usage",
    "name": "Default Token",
    "total_granted": 1000000,
    "total_used": 12345,
    "total_available": 987655,
    "unlimited_quota": false,
    "model_limits": {
      "gpt-4o-mini": true
    },
    "model_limits_enabled": false,
    "expires_at": 0
  }
}

❗ Ví dụ về phản hồi lỗi

Thiếu tiêu đề ủy quyền:

{
  "success": false,
  "message": "No Authorization header"
}

Lược đồ không hợp lệ (không phải Bearer):

{
  "success": false,
  "message": "Invalid Bearer token"
}

Tìm nạp mã thông báo không thành công (ví dụ: không hợp lệ hoặc bị xóa):

{
  "success": false,
  "message": "token not found"
}

🧾 Mô tả trường (dữ liệu)

object: Luôn là token_usage
name: Tên token
total_granted: Tổng số được cấp (= đã sử dụng + có sẵn)
total_used: Hạn ngạch đã sử dụng
total_available: Hạn ngạch khả dụng còn lại
unlimited_quota: Token có hạn ngạch không giới hạn hay không
model_limits: Danh sách model được phép
model_limits_enabled: Giới hạn dành riêng cho từng model có được bật hay không
expires_at: Dấu thời gian Unix hết hạn tính bằng giây. 0 có nghĩa là không bao giờ hết hạn (phụ trợ chuẩn hóa -1 → 0).

Tham khảo: GET /api/usage/token được thêm vào trong PR #1161