Vai al contenuto principale
CometAPI offre due modi per controllare il saldo e l’utilizzo dell’account: la CometAPI CLI e l’API del servizio di query su query.cometapi.com.

​
CometAPI CLI

Il modo più rapido per controllare il saldo dal terminale. Consulta la panoramica di CometAPI CLI per l’installazione. 
cometapi balance
Aggiungi --source token per i dettagli per chiave: 
cometapi balance --source token
Consulta il riferimento dei comandi per tutte le opzioni disponibili.

​
API del servizio di query

GET https://query.cometapi.com/user/quota Restituisce il saldo a livello di account, l’utilizzo cumulativo, il conteggio totale delle richieste e i dettagli della quota per chiave. Questo endpoint utilizza un servizio di query separato su query.cometapi.com e si autentica tramite il parametro di query key anziché con un Bearer Token.
Genera una API key dedicata per le query del saldo e imposta la sua quota a 0 (permesso solo query). Anche se la chiave viene divulgata, non può essere usata per richieste ai model.

​
Parametri della richiesta

ParameterTypeRequiredDescription
keystringYesLa tua API key CometAPI
start_datestringNoData di inizio per la suddivisione giornaliera (formato YYYY-MM-DD)
end_datestringNoData di fine per la suddivisione giornaliera (formato YYYY-MM-DD)
Quando vengono forniti start_date e end_date, la risposta include un campo daily_quota con l’utilizzo per chiave suddiviso per giorno.

​
Campi della risposta

FieldTypeDescription
usernamestringNome utente
total_quotanumberSaldo attuale dell’account (USD)
total_used_quotanumberUtilizzo cumulativo (USD)
request_countintegerConteggio totale delle richieste
keysarrayDettagli della quota per chiave
keys[].namestringNome della API key
keys[].remain_quotanumberQuota residua della chiave; -1 significa illimitata
keys[].used_quotanumberQuota utilizzata della chiave; -1 significa illimitata
daily_quotaobjectSuddivisione dell’utilizzo giornaliero (solo quando start_date e end_date sono impostati)
daily_quota[date]arrayVoci di utilizzo per chiave per quella data
daily_quota[date][].token_namestringNome della API key
daily_quota[date][].quota_usednumberUtilizzo per quella chiave in quella data (USD)
daily_quota[date][].request_countintegerConteggio delle richieste per quella chiave in quella data

​
Esempi di codice

Interroga il saldo dell’account: 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"

​
Esempio di risposta

{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "keys": [
    {
      "name": "my-key",
      "remain_quota": 8.94,
      "used_quota": 2.10
    }
  ]
}

​
Esempio di suddivisione giornaliera

Interroga l’utilizzo giornaliero per un intervallo di date: 
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
La risposta include gli stessi campi di primo livello più daily_quota: 
{
  "username": "example_user",
  "total_quota": 2105.23,
  "total_used_quota": 21.07,
  "request_count": 1221,
  "daily_quota": {
    "2026-04-13T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 4.27,
        "request_count": 59
      }
    ],
    "2026-04-14T00:00:00Z": [
      {
        "token_name": "my-key",
        "quota_used": 0.57,
        "request_count": 36
      }
    ]
  }
}