Account Balance

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

Reference for Account Balance.

Get current credit balance. Check this before submitting generation jobs to ensure sufficient credits.

cURL

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

Response

json
{
  "success": true,
  "data": {
    "freeCredit": 50,
    "purchasedCredit": 100,
    "lockedCredit": 8,
    "availableCredit": 142,
    "hasPurchased": true,
    "apiKey": "stai_a1b2c3d4e5f6...",
    "topupMemo": "891188"
  }
}
FieldTypeDescription
freeCreditnumberFree credits from subscription plan / trial bonus. Resets monthly
purchasedCreditnumberPurchased credits. Never expire
lockedCreditnumberCredits held for currently running jobs
availableCreditnumberfreeCredit + purchasedCredit - lockedCredit
hasPurchasedbooleanWhether user has ever purchased credits
apiKeystringThe account's legacy API key, in full — treat the response as a secret
topupMemostringMemo/reference code for bank transfer top-up

Deduction Order

Note: Credits are deducted from freeCredit first, then purchasedCredit. Check availableCredit >= estimated cost before submitting a job.
PreviousRender VideoNextList Jobs