Số dư credit

GEThttps://sangtao.ai/api/v2/account/balance

Tài liệu cho Số dư credit.

Lấy số dư credit hiện tại. Kiểm tra trước khi gửi job tạo nội dung để đảm bảo đủ credit.

cURL

bash
curl https://sangtao.ai/api/v2/account/balance \
  -H "X-Api-Key: YOUR_API_KEY"

Phản hồi

json
{
  "success": true,
  "data": {
    "freeCredit": 50,
    "purchasedCredit": 100,
    "lockedCredit": 8,
    "availableCredit": 142,
    "hasPurchased": true,
    "apiKey": "stai_a1b2c3d4e5f6...",
    "topupMemo": "891188"
  }
}
FieldTypeDescription
freeCreditnumberCredit miễn phí từ gói subscription / bonus dùng thử. Reset hàng tháng
purchasedCreditnumberCredit đã mua. Không hết hạn
lockedCreditnumberCredit đang giữ cho các job đang chạy
availableCreditnumberfreeCredit + purchasedCredit - lockedCredit
hasPurchasedbooleanUser đã từng mua credit chưa
apiKeystringAPI key cũ của tài khoản, trả về đầy đủ — coi response này là bí mật
topupMemostringMã tham chiếu cho nạp credit qua chuyển khoản

Thứ tự trừ credit

Note: Credit trừ từ freeCredit trước, rồi mới đến purchasedCredit. Kiểm tra availableCredit >= chi phí ước tính trước khi gửi job.