Interrogare saldo e utilizzo

CometAPI offre due modi per controllare il saldo e l’utilizzo dell’account: la CLI di CometAPI e l’API del servizio di interrogazione su query.cometapi.com. Se utilizzi un Workspace, consulta Gestire un team con CometAPI Workspace per comprendere gli Organization Credits condivisi e i ruoli di fatturazione.

CLI di CometAPI

Controlla il tuo saldo dal terminale con un solo comando. Consulta la panoramica della CLI di CometAPI 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 invece di un Bearer Token.

Usa una chiave API dedicata per le query del saldo. Se vuoi limitare l’esposizione, disattiva Unlimited Quota e imposta il più piccolo limite di credito positivo consentito dalla dashboard.

Parametri della richiesta

Parameter	Type	Required	Description
`key`	string	Yes	La tua chiave API CometAPI
`start_date`	string	No	Data di inizio per la suddivisione giornaliera (formato `YYYY-MM-DD`)
`end_date`	string	No	Data 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

Field	Type	Description
`username`	string	Nome utente
`total_quota`	number	Saldo attuale dell’account (USD)
`total_used_quota`	number	Utilizzo cumulativo (USD)
`request_count`	integer	Conteggio totale delle richieste
`keys`	array	Dettagli della quota per chiave
`keys[].name`	string	Nome della chiave API
`keys[].remain_quota`	number	Quota rimanente della chiave; `-1` significa illimitata
`keys[].used_quota`	number	Quota utilizzata della chiave; `-1` significa illimitata
`daily_quota`	object	Suddivisione dell’utilizzo giornaliero (solo quando `start_date` e `end_date` sono impostati)
`daily_quota[date]`	array	Voci di utilizzo per chiave per quella data
`daily_quota[date][].token_name`	string	Nome della chiave API
`daily_quota[date][].quota_used`	number	Utilizzo per quella chiave in quella data (USD)
`daily_quota[date][].request_count`	integer	Conteggio 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"

import os
import requests

resp = requests.get(
    "https://query.cometapi.com/user/quota",
    params={"key": os.environ["COMETAPI_KEY"]}
)
data = resp.json()
print(f"Balance: ${data['total_quota']:.2f}")
print(f"Used: ${data['total_used_quota']:.2f}")
print(f"Requests: {data['request_count']}")

const resp = await fetch(
  `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
);
const data = await resp.json();
console.log(`Balance: $${data.total_quota.toFixed(2)}`);
console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
console.log(`Requests: ${data.request_count}`);

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
      }
    ]
  }
}

Inizia qui

Guide rapide alle API dei modelli

Guide principali API

Librerie

Errori

Prezzi e fatturazione

Supporto

CLI di CometAPI

API del servizio di query

Parametri della richiesta

Campi della risposta

Esempi di codice

Esempio di risposta

Esempio di suddivisione giornaliera

​CLI di CometAPI

​API del servizio di query

​Parametri della richiesta

​Campi della risposta

​Esempi di codice

​Esempio di risposta

​Esempio di suddivisione giornaliera

CLI di CometAPI

API del servizio di query

Parametri della richiesta

Campi della risposta

Esempi di codice

Esempio di risposta

Esempio di suddivisione giornaliera