Riferimento API

API dei crediti

GET /v1/credits restituisce il saldo dell'organizzazione, e la spesa e i budget della chiave con cui chiami.

Leggi il saldo senza spendere nulla. La chiamata è gratuita e non riserva niente.

GEThttps://api.notholy.com/v1/credits

GET https://api.notholy.com/v1/credits

curl

curl https://api.notholy.com/v1/credits -H "Authorization: Bearer $NOTHOLY_API_KEY"

Risposta

JSON

{
  "object": "credits",
  "currency": "USD",
  "balance": "24.913402",
  "reserved": "0.004000",
  "available": "24.909402",
  "key": { "spent": "0.086598", "daily_budget": "5.000000" }
}

Campo	Tipo	Note
`object`	string	Sempre `credits`
`currency`	string	Sempre `USD`
`balance`	string	Crediti meno l'utilizzo già addebitato
`reserved`	string	Riservato in questo momento dalle richieste in corso. Ogni riserva è il costo massimo della sua richiesta; la parte non usata torna quando la richiesta si chiude
`available`	string	Quanto può riservare una nuova richiesta: `balance` meno `reserved`
`key.spent`	string	Totale speso con questa chiave
`key.total_budget`, `key.daily_budget`	string	Presenti quando la chiave ha dei budget

Gli importi sono stringhe decimali con 6 cifre decimali. Dentro NotHoly sono interi in miliardesimi di dollaro, quindi tra una richiesta e l'altra non avviene alcun arrotondamento.

Ogni richiesta riserva il suo caso peggiore (prompt più max_tokens) prima di partire. Quando available è inferiore, il limite di output si riduce per starci, e sotto i 16 token la richiesta restituisce 402 insufficient_credits. Controlla available prima di generazioni lunghe.

JavaScript

const r = await fetch('https://api.notholy.com/v1/credits', { headers: { Authorization: `Bearer ${process.env.NOTHOLY_API_KEY}` } });
const c = await r.json();
console.log(c.available);

Errori

Stato	Codice	Significato
401	`invalid_api_key`	Chiave mancante, non valida, revocata o scaduta
403	`account_suspended`, `consent_required`	Vedi Autenticazione
500	`internal_error`	Non è stato possibile leggere il saldo. Riprova con backoff