sangtao.ai
API key

Tài khoản

Số dư credit

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

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

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.

Response

  • freeCreditnumber

    Credit miễn phí từ gói subscription / bonus dùng thử. Reset hàng tháng

  • purchasedCreditnumber

    Credit đã mua. Không hết hạn

  • lockedCreditnumber

    Credit đang giữ cho các job đang chạy

  • availableCreditnumber

    freeCredit + purchasedCredit - lockedCredit

  • hasPurchasedboolean

    User đã từng mua credit chưa

  • topupMemostring

    Mã tham chiếu cho nạp credit qua chuyển khoản

  • isTelegramLinkedboolean

    true khi tài khoản có kênh nhận thông báo đang bật (ví dụ Telegram)

  • trialOfferobject | null

    Gói dùng thử tài khoản mới còn mua được. null khi không có

    Hiện thuộc tính con

    • eligibleboolean

      Còn mua được không

    • expiresAtstring | null

      Hạn chót để mua, ISO 8601 giờ UTC (có Z). Hạn của lời mời, không phải hạn của credit

    • remainingSlotsnumber | null

      Số suất còn lại — chỉ có khi sắp hết, còn lại là null

    • priceVndnumber

      Giá phải trả (VND)

    • creditsnumber

      Tổng credit nhận được, đã gồm phần tặng

    • bonusCreditsnumber

      Phần tặng thêm trong credits

Thứ tự trừ credit

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.
GET/account/balance
curl "https://api.sangtao.ai/v2/account/balance" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "freeCredit": 50,
    "purchasedCredit": 100,
    "lockedCredit": 8,
    "availableCredit": 142,
    "hasPurchased": true,
    "topupMemo": "891188",
    "isTelegramLinked": false,
    "trialOffer": null
  }
}