用一个 GET 请求查询当前 API Key 所属账户的余额(美元积分)。只读、永不扣费 —— 适合在你的后台、计费看板或自动告警里实时监控额度。
GET /api/v1/balance
Authorization: Bearer <API_KEY>cURL
curl https://apimodels.app/api/v1/balance \
-H "Authorization: Bearer $API_KEY"Python
import requests, os
r = requests.get(
"https://apimodels.app/api/v1/balance",
headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
)
data = r.json()["data"]
print(f"Available: ${data['balance']} {data['currency']}")
print(f"Total: ${data['total']} Frozen: ${data['frozen']}")Node.js
const r = await fetch("https://apimodels.app/api/v1/balance", {
headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
const { data } = await r.json();
console.log(`Available: $${data.balance} ${data.currency}`);{
"code": 200,
"msg": "success",
"data": {
"balance": 12.5,
"total": 12.5,
"frozen": 0,
"currency": "USD"
}
}| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| data.balance | — | number | 可用余额 = 总额 − 冻结(可直接消费的额度) |
| data.total | — | number | 账户总积分 |
| data.frozen | — | number | 被临时冻结的积分(如异常邀请活动),不可用 |
| data.currency | — | string | 货币单位,固定为 "USD" |