Read credit balance / 查询积分余额
curl --request GET \
--url https://apistable.com/v1/balance \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apistable.com/v1/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apistable.com/v1/balance"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"balance_credits": 1,
"reserved_credits": 1,
"available_credits": 1
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Core concepts
Credits & billing
Buy credits in USD. See exactly how each result is charged.
GET
/
v1
/
balance
Read credit balance / 查询积分余额
curl --request GET \
--url https://apistable.com/v1/balance \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apistable.com/v1/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apistable.com/v1/balance"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"balance_credits": 1,
"reserved_credits": 1,
"available_credits": 1
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}API preview: generation providers are not connected. An authenticated request can return 503 without creating a task or charging credits.
Purchased, reserved, available
Payment orders record USD and the number of credits issued. Model consumption is recorded in Credits. Purchased credits are not API usage. Your available balance is the ledger balance minus outstanding reservations. Pricing shown during preview is illustrative. The production exchange rate, payment channel, and active channel prices must be published before paid execution is enabled. View pricing Open billingRead your balance
GET /v1/balance requires usage:read. It returns balance_credits, reserved_credits, and available_credits. A new account may correctly return zero. The endpoint never creates trial credits or runs a payment.{
"balance_credits": 0,
"reserved_credits": 0,
"available_credits": 0
}
Four results, one clear total
| Result | Charge | Released |
|---|---|---|
| Low-cost success | 20 Credits | 40 Credits |
| Low-cost success | 20 Credits | 40 Credits |
| Official success | 60 Credits | 0 Credits |
| Both attempts failed | 0 Credits | 60 Credits |
| Total / 240 initially reserved | 100 Credits | 140 Credits |
Example only. Failed attempts are platform costs; they are not added to the user’s bill. Each result item has at most one final consumption entry.
Prices are locked at acceptance
- Each channel has its own parameter-based price, including rounding, minimum units, and applicable surcharges.
- Official success uses the disclosed official rate; low-cost success uses the low-cost rate. A later price edit cannot increase an accepted request’s cap.
- Unknown items retain only their own reservation. Known successful and failed siblings can settle or release independently.
- LLM stream interruption and native music bundles use their own published metering rules, not the image/video rule by assumption.
Authorizations
API key beginning as_. Keep on the server. Scope permissions are checked separately.