Naar hoofdinhoud gaan
CometAPI biedt twee manieren om het accountsaldo en gebruik te controleren: de CometAPI CLI en de query service API op query.cometapi.com.

CometAPI CLI

De snelste manier om je saldo vanuit de terminal te controleren. Zie CometAPI CLI overview voor installatie.
cometapi balance
Voeg --source token toe voor details per sleutel:
cometapi balance --source token
Zie de commands reference voor alle beschikbare opties.

Query service API

GET https://query.cometapi.com/user/quota Geeft saldo op accountniveau, cumulatief gebruik, het totale aantal requests en quota-details per sleutel terug. Dit endpoint gebruikt een aparte query service op query.cometapi.com en authenticatie verloopt via de queryparameter key in plaats van een Bearer Token.
Genereer een aparte API-sleutel voor saldoqueries en stel de quota in op 0 (alleen query-rechten). Zelfs als de sleutel uitlekt, kan deze niet worden gebruikt voor modelrequests.

Request parameters

ParameterTypeRequiredDescription
keystringYesJe CometAPI API-sleutel
start_datestringNoStartdatum voor dagelijkse uitsplitsing (YYYY-MM-DD-indeling)
end_datestringNoEinddatum voor dagelijkse uitsplitsing (YYYY-MM-DD-indeling)
Wanneer start_date en end_date zijn opgegeven, bevat de response een veld daily_quota met gebruik per sleutel uitgesplitst per dag.

Response fields

FieldTypeDescription
usernamestringGebruikersnaam
total_quotanumberHuidig accountsaldo (USD)
total_used_quotanumberCumulatief gebruik (USD)
request_countintegerTotaal aantal requests
keysarrayQuota-details per sleutel
keys[].namestringNaam van de API-sleutel
keys[].remain_quotanumberResterende quota van de sleutel; -1 betekent onbeperkt
keys[].used_quotanumberGebruikte quota van de sleutel; -1 betekent onbeperkt
daily_quotaobjectDagelijkse gebruiksuitsplitsing (alleen wanneer start_date en end_date zijn ingesteld)
daily_quota[date]arrayGebruiksinvoer per sleutel voor die datum
daily_quota[date][].token_namestringNaam van de API-sleutel
daily_quota[date][].quota_usednumberGebruik voor die sleutel op die datum (USD)
daily_quota[date][].request_countintegerAantal requests voor die sleutel op die datum

Code examples

Vraag het accountsaldo op:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"

Response example

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

Daily breakdown example

Vraag dagelijks gebruik op voor een datumbereik:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
De response bevat dezelfde velden op het hoogste niveau plus 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
      }
    ]
  }
}