Interroger le solde et l’utilisation

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 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 pour l’installation.

cometapi balance

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

cometapi balance --source token

Consultez la référence des commandes 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.

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.

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 :

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}`);

Exemple de réponse

{
  "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 :

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 :

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

Commencez ici

Démarrages rapides de l’API des modèles

Guides de l’API principale

Bibliothèques

Erreurs

Tarification et facturation

Assistance

Interroger le solde et l’utilisation

CLI CometAPI

API du service de requête

Paramètres de requête

Champs de réponse

Exemples de code

Exemple de réponse

Exemple de ventilation quotidienne

​CLI CometAPI

​API du service de requête

​Paramètres de requête

​Champs de réponse

​Exemples de code

​Exemple de réponse

​Exemple de ventilation quotidienne

CLI CometAPI

API du service de requête

Paramètres de requête

Champs de réponse

Exemples de code

Exemple de réponse

Exemple de ventilation quotidienne