Hopp til hovedinnhold
CometAPI tilbyr to måter å sjekke kontosaldo og bruk på: CometAPI CLI og query service APIquery.cometapi.com.

CometAPI CLI

Den raskeste måten å sjekke saldoen din fra terminalen på. Se oversikt over CometAPI CLI for installasjon.
cometapi balance
Legg til --source token for detaljer per nøkkel:
cometapi balance --source token
Se kommandoreferansen for alle tilgjengelige alternativer.

Query service API

GET https://query.cometapi.com/user/quota Returnerer saldo på kontonivå, kumulativ bruk, totalt antall forespørsler og kvotedetaljer per nøkkel. Dette endepunktet bruker en separat query service på query.cometapi.com og autentiserer via spørringsparameteren key i stedet for en Bearer Token.
Generer en dedikert API-nøkkel for saldoforespørsler og sett kvoten til 0 (kun query-tillatelse). Selv om nøkkelen lekker, kan den ikke brukes til modellforespørsler.

Request parameters

ParameterTypeRequiredDescription
keystringYesCometAPI API-nøkkelen din
start_datestringNoStartdato for daglig oppdeling (format YYYY-MM-DD)
end_datestringNoSluttdato for daglig oppdeling (format YYYY-MM-DD)
Når start_date og end_date oppgis, inkluderer svaret et daily_quota-felt med bruk per nøkkel fordelt per dag.

Response fields

FieldTypeDescription
usernamestringBrukernavn
total_quotanumberGjeldende kontosaldo (USD)
total_used_quotanumberKumulativ bruk (USD)
request_countintegerTotalt antall forespørsler
keysarrayKvotedetaljer per nøkkel
keys[].namestringAPI-nøkkelnavn
keys[].remain_quotanumberGjenstående kvote for nøkkelen; -1 betyr ubegrenset
keys[].used_quotanumberBrukt kvote for nøkkelen; -1 betyr ubegrenset
daily_quotaobjectDaglig bruksoppdeling (kun når start_date og end_date er satt)
daily_quota[date]arrayBruksoppføringer per nøkkel for den datoen
daily_quota[date][].token_namestringAPI-nøkkelnavn
daily_quota[date][].quota_usednumberBruk for den nøkkelen på den datoen (USD)
daily_quota[date][].request_countintegerAntall forespørsler for den nøkkelen på den datoen

Kodeeksempler

Spørr kontosaldo:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"

Eksempel på svar

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

Eksempel på daglig oppdeling

Spørr daglig bruk for et datointervall:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
Svaret inkluderer de samme feltene på toppnivå pluss 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
      }
    ]
  }
}