Kontostand und Nutzung abfragen

CometAPI bietet zwei Möglichkeiten, Kontostand und Nutzung zu prüfen: die CometAPI CLI und die query service API unter query.cometapi.com. Wenn Sie einen Workspace verwenden, finden Sie unter Ein Team mit CometAPI Workspace verwalten Informationen zu gemeinsamen Organization Credits und Abrechnungsrollen.

CometAPI CLI

Prüfen Sie Ihren Kontostand mit einem einzigen Befehl direkt im Terminal. Informationen zur Installation finden Sie in der CometAPI CLI overview.

cometapi balance

Fügen Sie --source token hinzu, um Details pro Schlüssel anzuzeigen:

cometapi balance --source token

Alle verfügbaren Optionen finden Sie in der commands reference.

Query service API

GET https://query.cometapi.com/user/quota Gibt den Kontostand auf Kontoebene, die kumulative Nutzung, die Gesamtzahl der Requests und 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.

Verwenden Sie einen dedizierten API-Schlüssel für Kontostandsabfragen. Wenn Sie die Offenlegung begrenzen möchten, deaktivieren Sie Unlimited Quota und setzen Sie das kleinste positive Kreditlimit, das im Dashboard erlaubt ist.

Request-Parameter

Parameter	Typ	Erforderlich	Beschreibung
`key`	string	Ja	Ihr CometAPI API-Schlüssel
`start_date`	string	Nein	Startdatum für die tägliche Aufschlüsselung (Format `YYYY-MM-DD`)
`end_date`	string	Nein	Enddatum für die tägliche Aufschlüsselung (Format `YYYY-MM-DD`)

Wenn start_date und end_date angegeben werden, enthält die Antwort ein Feld daily_quota mit der täglichen Nutzung pro Schlüssel.

Antwortfelder

Feld	Typ	Beschreibung
`username`	string	Benutzername
`total_quota`	number	Aktueller Kontostand (USD)
`total_used_quota`	number	Kumulative Nutzung (USD)
`request_count`	integer	Gesamtzahl der Requests
`keys`	array	Kontingentdetails pro Schlüssel
`keys[].name`	string	API-Schlüsselname
`keys[].remain_quota`	number	Verbleibendes Kontingent des Schlüssels; `-1` bedeutet unbegrenzt
`keys[].used_quota`	number	Genutztes 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	API-Schlüsselname
`daily_quota[date][].quota_used`	number	Nutzung für diesen Schlüssel an diesem Datum (USD)
`daily_quota[date][].request_count`	integer	Request-Anzahl für diesen Schlüssel an diesem Datum

Codebeispiele

Kontostand abfragen:

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

import os
import requests

resp = requests.get(
    "https://query.cometapi.com/user/quota",
    params={"key": os.environ["COMETAPI_KEY"]}
)
data = resp.json()
print(f"Balance: ${data['total_quota']:.2f}")
print(f"Used: ${data['total_used_quota']:.2f}")
print(f"Requests: {data['request_count']}")

const resp = await fetch(
  `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`
);
const data = await resp.json();
console.log(`Balance: $${data.total_quota.toFixed(2)}`);
console.log(`Used: $${data.total_used_quota.toFixed(2)}`);
console.log(`Requests: ${data.request_count}`);

Antwortbeispiel

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

Beispiel für tägliche Aufschlüsselung

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"

Die Antwort enthält dieselben Felder der obersten Ebene 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
      }
    ]
  }
}

Hier starten

Schnellstarts für Modell-APIs

Core API-Anleitungen

Bibliotheken

Fehler

Preise und Abrechnung

Support

CometAPI CLI

Query service API

Request-Parameter

Antwortfelder

Codebeispiele

Antwortbeispiel

Beispiel für tägliche Aufschlüsselung

​CometAPI CLI

​Query service API

​Request-Parameter

​Antwortfelder

​Codebeispiele

​Antwortbeispiel

​Beispiel für tägliche Aufschlüsselung

CometAPI CLI

Query service API

Request-Parameter

Antwortfelder

Codebeispiele

Antwortbeispiel

Beispiel für tägliche Aufschlüsselung