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-overzicht voor installatie.
cometapi balance
Voeg --source token toe voor details per sleutel:
cometapi balance --source token
Zie de opdrachtenreferentie voor alle beschikbare opties.

Query service API

GET https://query.cometapi.com/user/quota Retourneert saldo op accountniveau, cumulatief gebruik, totaal aantal requests en quota-details per sleutel. 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 key voor saldoqueries en stel de quota in op 0 (alleen querytoestemming). Zelfs als de sleutel uitlekt, kan deze niet worden gebruikt voor modelrequests.

Request parameters

ParameterTypeRequiredDescription
keystringYesJe CometAPI API key
start_datestringNoStartdatum voor dagelijkse uitsplitsing (indeling YYYY-MM-DD)
end_datestringNoEinddatum voor dagelijkse uitsplitsing (indeling YYYY-MM-DD)
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[].namestringAPI key-naam
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]arrayGebruiksitems per sleutel voor die datum
daily_quota[date][].token_namestringAPI key-naam
daily_quota[date][].quota_usednumberGebruik voor die sleutel op die datum (USD)
daily_quota[date][].request_countintegerAantal requests voor die sleutel op die datum

Codevoorbeelden

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

Responsevoorbeeld

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

Voorbeeld van dagelijkse uitsplitsing

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