aisplice

Riferimento API

Saldo

GET/v1/balance

Restituisce il saldo dell'account e quanto la chiave API chiamante può ancora spendere, in USD. Gratis e in sola lettura: nessuna chiamata a modelli, nessun addebito. Anche le chiavi esaurite o scadute possono chiamarlo; vengono rifiutate solo le chiavi disattivate.

#Parametri della richiesta

  • Authorizationheaderobbligatorio

    Bearer sk-YOUR_KEY. Non ci sono corpo né parametri di query.

balance è l'intero portafoglio dell'account e può scendere sotto zero dopo il conguaglio di un job grande. available è quanto questa chiave può spendere in questo momento: il minore tra balance e il limite residuo della chiave, mai sotto zero. key.remaining è null quando la chiave non ha un proprio limite; expires_at 0 significa che non scade mai.

I chiamanti B2B possono interrogarlo prima di inviare lavoro e avvisare il team quando available si sta esaurendo. Con la firma delle richieste attiva, firmalo come qualsiasi altra chiamata con quella chiave, usando il percorso /v1/balance.

#Errori correlati

  • 401Chiave mancante, non valida o disattivata — oppure, con la firma delle richieste attiva, una firma mancante o errata.
  • 403L'account è disattivato.
  • 500Impossibile leggere il saldo. Riprova tra qualche secondo.

Tabella completa dei codici di errore →

#Esempio di richiesta

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#Risposta

response.json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

Non hai ancora risolto?

Inviaci l'ID richiesta o il messaggio di errore e verificheremo.

PrecedentePolicy di upload dei fileSuccessivoElenco dei modelli