Una sola petición GET devuelve el saldo de créditos (en USD) de la cuenta propietaria de la clave API. Es de solo lectura y nunca genera cargos: ideal para tu propio panel, widget de facturación o alertas de saldo bajo.
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 disponible = total − congelado (lo que puedes gastar) |
| data.total | — | number | Total de créditos en la cuenta |
| data.frozen | — | number | Créditos congelados temporalmente (p. ej. por actividad de invitación anómala), no utilizables |
| data.currency | — | string | Moneda, siempre "USD" |