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-overzicht voor installatie.
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
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Je CometAPI API key |
start_date | string | No | Startdatum voor dagelijkse uitsplitsing (indeling YYYY-MM-DD) |
end_date | string | No | Einddatum 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
| 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 | API key-naam |
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 | Gebruiksitems per sleutel voor die datum |
daily_quota[date][].token_name | string | API key-naam |
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 |
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
}
]
}
}