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

# Interroger le solde et l’utilisation

> Utilisez le CLI CometAPI ou l’API du service de requête pour récupérer le solde du compte, l’utilisation et les détails de quota par clé.

CometAPI propose deux façons de vérifier le solde du compte et l’utilisation : le **CLI CometAPI** et l’**API du service de requête** sur `query.cometapi.com`.

Si vous utilisez un Workspace, consultez [Gérer une équipe avec CometAPI Workspace](/fr/workspace/overview) pour comprendre les Organization Credits partagés et les rôles de facturation.

***

## CLI CometAPI

Vérifiez votre solde depuis le terminal avec une seule commande. Consultez la [vue d’ensemble du CLI CometAPI](/fr/libraries/cli/overview) pour l’installation.

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

Ajoutez `--source token` pour obtenir les détails par clé :

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

Consultez la [référence des commandes](/fr/libraries/cli/commands) pour voir toutes les options disponibles.

***

## API du service de requête

`GET https://query.cometapi.com/user/quota`

Renvoie le solde au niveau du compte, l’utilisation cumulée, le nombre total de requêtes et les détails de quota par clé. Ce endpoint utilise un service de requête distinct sur `query.cometapi.com` et s’authentifie via le paramètre de requête `key` plutôt qu’avec un Bearer Token.

<Tip>
  Utilisez une clé API dédiée pour les requêtes de solde. Si vous souhaitez limiter l’exposition, désactivez Unlimited Quota et définissez la plus petite limite de crédit positive autorisée par le tableau de bord.
</Tip>

### Paramètres de requête

| Parameter    | Type   | Required | Description                                                         |
| ------------ | ------ | -------- | ------------------------------------------------------------------- |
| `key`        | string | Yes      | Votre clé API CometAPI                                              |
| `start_date` | string | No       | Date de début pour la ventilation quotidienne (format `YYYY-MM-DD`) |
| `end_date`   | string | No       | Date de fin pour la ventilation quotidienne (format `YYYY-MM-DD`)   |

Lorsque `start_date` et `end_date` sont fournis, la réponse inclut un champ `daily_quota` avec l’utilisation par clé ventilée par jour.

### Champs de réponse

| Field                               | Type    | Description                                                                                           |
| ----------------------------------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `username`                          | string  | Nom d’utilisateur                                                                                     |
| `total_quota`                       | number  | Solde actuel du compte (USD)                                                                          |
| `total_used_quota`                  | number  | Utilisation cumulée (USD)                                                                             |
| `request_count`                     | integer | Nombre total de requêtes                                                                              |
| `keys`                              | array   | Détails de quota par clé                                                                              |
| `keys[].name`                       | string  | Nom de la clé API                                                                                     |
| `keys[].remain_quota`               | number  | Quota restant de la clé ; `-1` signifie illimité                                                      |
| `keys[].used_quota`                 | number  | Quota utilisé de la clé ; `-1` signifie illimité                                                      |
| `daily_quota`                       | object  | Ventilation de l’utilisation quotidienne (uniquement lorsque `start_date` et `end_date` sont définis) |
| `daily_quota[date]`                 | array   | Entrées d’utilisation par clé pour cette date                                                         |
| `daily_quota[date][].token_name`    | string  | Nom de la clé API                                                                                     |
| `daily_quota[date][].quota_used`    | number  | Utilisation pour cette clé à cette date (USD)                                                         |
| `daily_quota[date][].request_count` | integer | Nombre de requêtes pour cette clé à cette date                                                        |

### Exemples de code

Interroger le solde du compte :

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

### Exemple de réponse

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

### Exemple de ventilation quotidienne

Interroger l’utilisation quotidienne pour une plage de dates :

```bash theme={null}
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"
```

La réponse inclut les mêmes champs de premier niveau ainsi que `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
      }
    ]
  }
}
```