> ## 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.

# Kontostand und Nutzung abfragen

> Verwenden Sie die CometAPI CLI oder die query service API, um Kontostand, Nutzung und Quota-Details pro Schlüssel abzurufen.

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](/de/workspace/overview) 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](/de/libraries/cli/overview).

```bash theme={null}
cometapi balance
```

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

```bash theme={null}
cometapi balance --source token
```

Alle verfügbaren Optionen finden Sie in der [commands reference](/de/libraries/cli/commands).

***

## 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.

<Tip>
  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.
</Tip>

### 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:

<CodeGroup>
  ```bash curl theme={null}
  curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
  ```

  ```python Python theme={null}
  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']}")
  ```

  ```javascript Node.js theme={null}
  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}`);
  ```
</CodeGroup>

### Antwortbeispiel

```json theme={null}
{
  "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:

```bash theme={null}
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`:

```json theme={null}
{
  "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
      }
    ]
  }
}
```