CometAPI bietet zwei Möglichkeiten, den Kontostand und die Nutzung zu prüfen: die CometAPI CLI und die API des Query-Service unter query.cometapi.com.
Der schnellste Weg, Ihren Kontostand im Terminal zu prüfen. Informationen zur Installation finden Sie in der CometAPI CLI overview.
Fügen Sie --source token für Details pro Schlüssel hinzu:
cometapi balance --source token
Query service API
GET https://query.cometapi.com/user/quota
Gibt den Kontostand auf Kontoebene, die kumulierte Nutzung, die Gesamtanzahl der Anfragen und die Kontingentdetails pro Schlüssel zurück. Dieser Endpunkt verwendet einen separaten Query-Service unter query.cometapi.com und authentifiziert über den Query-Parameter key anstelle eines Bearer Token.
Erstellen Sie einen dedizierten API-Schlüssel für Kontostandsabfragen und setzen Sie dessen Kontingent auf 0 (nur Abfrageberechtigung). Selbst wenn der Schlüssel offengelegt wird, kann er nicht für Modellanfragen verwendet werden.
Request parameters
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Ihr CometAPI API-Schlüssel |
start_date | string | No | Startdatum für die tägliche Aufschlüsselung (Format YYYY-MM-DD) |
end_date | string | No | Enddatum für die tägliche Aufschlüsselung (Format YYYY-MM-DD) |
start_date und end_date angegeben werden, enthält die Antwort ein Feld daily_quota mit der nach Tagen aufgeschlüsselten Nutzung pro Schlüssel.
Response fields
| Field | Type | Description |
|---|
username | string | Benutzername |
total_quota | number | Aktueller Kontostand des Kontos (USD) |
total_used_quota | number | Kumulierte Nutzung (USD) |
request_count | integer | Gesamtanzahl der Anfragen |
keys | array | Kontingentdetails pro Schlüssel |
keys[].name | string | Name des API-Schlüssels |
keys[].remain_quota | number | Verbleibendes Kontingent des Schlüssels; -1 bedeutet unbegrenzt |
keys[].used_quota | number | Verwendetes Kontingent des Schlüssels; -1 bedeutet unbegrenzt |
daily_quota | object | Tägliche Nutzungsaufschlüsselung (nur wenn start_date und end_date gesetzt sind) |
daily_quota[date] | array | Nutzungseinträge pro Schlüssel für dieses Datum |
daily_quota[date][].token_name | string | Name des API-Schlüssels |
daily_quota[date][].quota_used | number | Nutzung dieses Schlüssels an diesem Datum (USD) |
daily_quota[date][].request_count | integer | Anzahl der Anfragen für diesen Schlüssel an diesem Datum |
Code examples
Kontostand abfragen:
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
Tägliche Nutzung für einen Datumsbereich abfragen:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
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
}
]
}
}
