CometAPI fournit deux moyens 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.
Le moyen le plus rapide de vérifier votre solde depuis le terminal. Consultez la vue d’ensemble du 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 séparé 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 la requête
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Votre clé API CometAPI |
start_date | string | No | Date de début pour la répartition quotidienne (format YYYY-MM-DD) |
end_date | string | No | Date de fin pour la répartition 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 la 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 | Répartition quotidienne de l’utilisation (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 de 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 répartition 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
}
]
}
}
