Uma única requisição GET retorna o saldo de créditos (em USD) da conta dona da chave API. É somente leitura e nunca gera cobranças — perfeito para o seu próprio painel, widget de faturamento ou alertas de saldo baixo.
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"
}
}| Field | Required | Type | Description |
|---|---|---|---|
| data.balance | — | number | Saldo disponível = total − congelado (o que você pode gastar) |
| data.total | — | number | Total de créditos na conta |
| data.frozen | — | number | Créditos temporariamente congelados (ex.: atividade de convite anormal), não utilizáveis |
| data.currency | — | string | Moeda, sempre "USD" |