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 query-parameteren key i stedet for et Bearer Token.
Generer en dedikert API-nøkkel for saldoforespørsler og sett kvoten til 0 (kun query-tillatelse). Selv om nøkkelen lekkes, kan den ikke brukes til modellforespørsler.

Request parameters

ParameterTypeRequiredDescription
keystringJaDin CometAPI API-nøkkel
start_datestringNeiStartdato for daglig oppdeling (format YYYY-MM-DD)
end_datestringNeiSluttdato 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 på dag.

Response fields

FieldTypeDescription
usernamestringBrukernavn
total_quotanumberGjeldende kontosaldo (USD)
total_used_quotanumberKumulativ bruk (USD)
request_countintegerTotalt antall forespørsler
keysarrayKvoteopplysninger 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]arrayBruksposter 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å, i tillegg til 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
      }
    ]
  }
}