CometAPI biedt twee manieren om het accountsaldo en gebruik te controleren: de CometAPI CLI en de query service API op query.cometapi.com.
De snelste manier om je saldo vanuit de terminal te controleren. Zie CometAPI CLI overview voor installatie.
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
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Je CometAPI API-sleutel |
start_date | string | No | Startdatum voor dagelijkse uitsplitsing (YYYY-MM-DD-indeling) |
end_date | string | No | Einddatum 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
| Field | Type | Description |
|---|
username | string | Gebruikersnaam |
total_quota | number | Huidig accountsaldo (USD) |
total_used_quota | number | Cumulatief gebruik (USD) |
request_count | integer | Totaal aantal requests |
keys | array | Quota-details per sleutel |
keys[].name | string | Naam van de API-sleutel |
keys[].remain_quota | number | Resterende quota van de sleutel; -1 betekent onbeperkt |
keys[].used_quota | number | Gebruikte quota van de sleutel; -1 betekent onbeperkt |
daily_quota | object | Dagelijkse gebruiksuitsplitsing (alleen wanneer start_date en end_date zijn ingesteld) |
daily_quota[date] | array | Gebruiksinvoer per sleutel voor die datum |
daily_quota[date][].token_name | string | Naam van de API-sleutel |
daily_quota[date][].quota_used | number | Gebruik voor die sleutel op die datum (USD) |
daily_quota[date][].request_count | integer | Aantal 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
}
]
}
}