Balance API

Balance API cho phép bạn truy xuất số dư tín dụng hiện tại của tài khoản. Endpoint này cung cấp một cách đơn giản để kiểm tra số tín dụng khả dụng, được sử dụng cho nhiều dịch vụ khác nhau của Meshy.

GET/openapi/v1/balance

Lấy số dư

Endpoint này truy xuất số dư tín dụng hiện tại của người dùng đã xác thực.

Kết quả trả về

Trả về một đối tượng chứa số dư tín dụng hiện tại. Đối với thành viên nhóm, các giá trị này phản ánh kho tín dụng dùng chung của nhóm.

Name
balance
Type
integer
Description
Số tín dụng hiện có trong tài khoản của bạn.
Name
monthly_credits
Type
integer
Description
Số tín dụng còn lại sẽ hết hạn vào lần làm mới hàng tháng tiếp theo, theo thông tin được chỉ định tại monthly_resets_at.
Name
permanent_credits
Type
integer
Description
Số tín dụng không có thời hạn sử dụng, chẳng hạn như tín dụng từ các gói tín dụng đã mua hoặc phần thưởng đã nhận được.
Name
monthly_resets_at
Type
timestamp
Description
Thời điểm làm mới tín dụng hàng tháng tiếp theo, được biểu thị dưới dạng dấu thời gian Unix tính bằng mili giây. Vào thời điểm này, số tín dụng hàng tháng hiện tại sẽ hết hạn và được bổ sung, với điều kiện đăng ký đang hoạt động. Trả về null nếu không có lịch làm mới nào được lên lịch.

Thông thường, balance bằng monthly_credits + permanent_credits. Nếu giới hạn tín dụng của thành viên hoặc không gian làm việc được áp dụng cho người gọi, balance có thể thấp hơn.

Request

GET

/openapi/v1/balance

curl https://api.meshy.ai/openapi/v1/balance \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

{
  "balance": 1000,
  "monthly_credits": 600,
  "permanent_credits": 400,
  "monthly_resets_at": 1793491200000
}