Endpoint

Saldo e informazioni sulla chiave

Leggi il saldo in USD, la spesa totale e il limite di frequenza della chiave in uso con GET /credits e /key, e impara a evitare di restare senza credito.

Leggi il saldo in USD del tuo account, la spesa totale e il limite di frequenza della chiave che effettua la chiamata. Due percorsi restituiscono lo stesso corpo: /credits e /key, un alias più breve.

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

Tutti gli importi sono in dollari statunitensi.

Richiesta

Nessun parametro. Autenticati con la tua chiave API:

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

Risposta

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

Campo	Descrizione
`total_credits`	Totale in USD aggiunto all'account nel tempo: ricariche, utilizzo incluso nell'abbonamento, bonus e codici promozionali.
`total_usage`	Totale in USD speso per le richieste.
`balance_usd`	Saldo spendibile attuale in USD.
`key_id`	L'id della chiave API usata per questa richiesta.
`rate_limit.requests`	Il limite di richieste al minuto specifico della chiave, oppure `null` se la chiave usa il limite del tuo piano.
`rate_limit.interval`	Sempre `1m`.

total_credits - total_usage può differire leggermente da balance_usd a causa di rimborsi e rettifiche manuali; fa fede balance_usd.

Esempio: fermarsi prima di restare senza credito

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

Quando il saldo arriva a $0

Le richieste a pagamento restituiscono 402 insufficient_balance finché non aggiungi fondi, a meno che la ricarica automatica sia attiva in Fatturazione. La lettura di /credits, /key e /models continua a funzionare. Vedi Prezzi e fatturazione.

Errori

Stato	Codice	Quando
401	`invalid_api_key`	Chiave mancante o non valida.

Vedi Errori.