CometAPI propose deux façons de vérifier le solde du compte et l’utilisation : la CLI CometAPI et l’API du service de requête sur query.cometapi.com.
La façon la plus rapide de vérifier votre solde depuis le terminal. Consultez la présentation de la CLI CometAPI pour l’installation.
Ajoutez --source token pour obtenir les détails par clé :
cometapi balance --source token
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 point de terminaison 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.
Générez une clé API dédiée aux requêtes de solde et définissez son quota à 0 (permission de requête uniquement). Même si la clé est divulguée, elle ne peut pas être utilisée pour des requêtes de modèle.
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) |
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"
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"
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
}
]
}
}
