Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

CometAPI bietet zwei Möglichkeiten, Kontoguthaben und Nutzung zu prüfen: die CometAPI CLI und die query service API unter query.cometapi.com.

​
CometAPI CLI

Der schnellste Weg, Ihr Guthaben im Terminal zu prüfen. Informationen zur Installation finden Sie in der CometAPI CLI-Übersicht. 
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 Befehlsreferenz.

​
Query service API

GET https://query.cometapi.com/user/quota Gibt das Kontoguthaben auf Kontoebene, die kumulierte Nutzung, die Gesamtzahl der Anfragen und die Quota-Details pro Schlüssel zurück. Dieser Endpunkt verwendet einen separaten query service unter query.cometapi.com und authentifiziert über den Query-Parameter key statt über ein Bearer Token.
Erstellen Sie einen dedizierten API key für Guthabenabfragen und setzen Sie seine Quota auf 0 (nur Abfrageberechtigung). Selbst wenn der Schlüssel offengelegt wird, kann er nicht für Modellanfragen verwendet werden.

​
Anfrageparameter

ParameterTypErforderlichBeschreibung
keystringJaIhr CometAPI API key
start_datestringNeinStartdatum für die tägliche Aufschlüsselung (Format YYYY-MM-DD)
end_datestringNeinEnddatum 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 nach Tagen aufgeschlüsselten Nutzung pro Schlüssel.

​
Antwortfelder

FieldTypBeschreibung
usernamestringBenutzername
total_quotanumberAktuelles Kontoguthaben (USD)
total_used_quotanumberKumulierte Nutzung (USD)
request_countintegerGesamtzahl der Anfragen
keysarrayQuota-Details pro Schlüssel
keys[].namestringAPI-Schlüsselname
keys[].remain_quotanumberVerbleibende Quota des Schlüssels; -1 bedeutet unbegrenzt
keys[].used_quotanumberVerwendete Quota des Schlüssels; -1 bedeutet unbegrenzt
daily_quotaobjectTägliche Nutzungsaufschlüsselung (nur wenn start_date und end_date gesetzt sind)
daily_quota[date]arrayNutzungseinträge pro Schlüssel für dieses Datum
daily_quota[date][].token_namestringAPI-Schlüsselname
daily_quota[date][].quota_usednumberNutzung dieses Schlüssels an diesem Datum (USD)
daily_quota[date][].request_countintegerAnzahl der Anfragen für diesen Schlüssel an diesem Datum

​
Codebeispiele

Kontoguthaben abfragen: 
curl `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`

​
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
      }
    ]
  }
}