Bỏ qua nội dung
4ALL API Docs
Trang chính Tin tức Bảng điều khiển

API tra cứu số dư

4ALL API cung cấp hai giao diện truy vấn tương thích với OpenAI, cho phép dùng API token để truy vấn trực tiếp số dư còn lại và mức tiêu thụ tích lũy, thuận tiện cho việc thiết lập cảnh báo số dư hoặc bảng điều khiển mức sử dụng ở phía nghiệp vụ.

Tra cứu hạn mức

Terminal window
curl https://api.4allapi.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $AIPROXY_KEY"

Ví dụ phản hồi:

{
  "object": "billing_subscription",
  "has_payment_method": true,
  "soft_limit_usd": 25.0,
  "hard_limit_usd": 25.0,
  "system_hard_limit_usd": 25.0,
  "access_until": 0
}
  • hard_limit_usd: tổng hạn mức khả dụng của token này (đã dùng + còn lại);
  • access_until: dấu thời gian hết hạn của token, 0 biểu thị còn hiệu lực lâu dài;
  • Nếu token được đặt không giới hạn hạn mức, trường này sẽ trả về một số lớn cố định.

Tra cứu mức đã dùng

Terminal window
curl https://api.4allapi.com/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $AIPROXY_KEY"

Ví dụ phản hồi:

{
  "object": "list",
  "total_usage": 123.45
}
  • Đơn vị của total_usage là cent (0.01 đô la Mỹ), 123.45 tức là $1.2345;
  • Số dư còn lại = hard_limit_usd − total_usage / 100.

Giải thích và lưu ý

  • Đường dẫn của hai giao diện không có tiền tố /v1 (/dashboard/billing/…) cũng có thể dùng;
  • Mặc định quy ước số liệu được thống kê theo token: trả về hạn mức và mức sử dụng của token hiện tại, không phải của toàn bộ tài khoản;
  • Giao diện này tương thích với các trường của giao diện billing chính thức của OpenAI, và hầu hết các client bên thứ ba hỗ trợ “hiển thị số dư” (như Cherry Studio, Chatbox) có thể dùng trực tiếp để hiển thị số dư;
  • Thăm dò tần suất cao là không có ý nghĩa, nên truy vấn theo chu kỳ phút hoặc thấp hơn.