CometAPI udostępnia dwa sposoby sprawdzania salda konta i użycia: CometAPI CLI oraz API usługi zapytań pod adresem query.cometapi.com.
Najszybszy sposób na sprawdzenie salda z poziomu terminala. Informacje o instalacji znajdziesz w przeglądzie CometAPI CLI.
Dodaj --source token, aby zobaczyć szczegóły dla poszczególnych kluczy:
cometapi balance --source token
API usługi zapytań
GET https://query.cometapi.com/user/quota
Zwraca saldo na poziomie konta, skumulowane użycie, łączną liczbę żądań oraz szczegóły limitów dla poszczególnych kluczy. Ten endpoint korzysta z oddzielnej usługi zapytań pod adresem query.cometapi.com i uwierzytelnia za pomocą parametru zapytania key, a nie Bearer Token.
Wygeneruj dedykowany klucz API do zapytań o saldo i ustaw jego limit na 0 (uprawnienie tylko do zapytań). Nawet jeśli klucz wycieknie, nie będzie można użyć go do żądań modeli.
Parametry żądania
| Parameter | Type | Required | Description |
|---|
key | string | Yes | Twój klucz API CometAPI |
start_date | string | No | Data początkowa dla dziennego zestawienia (format YYYY-MM-DD) |
end_date | string | No | Data końcowa dla dziennego zestawienia (format YYYY-MM-DD) |
start_date i end_date, odpowiedź zawiera pole daily_quota z rozbiciem użycia dla poszczególnych kluczy według dni.
Pola odpowiedzi
| Field | Type | Description |
|---|
username | string | Nazwa użytkownika |
total_quota | number | Bieżące saldo konta (USD) |
total_used_quota | number | Skumulowane użycie (USD) |
request_count | integer | Łączna liczba żądań |
keys | array | Szczegóły limitów dla poszczególnych kluczy |
keys[].name | string | Nazwa klucza API |
keys[].remain_quota | number | Pozostały limit klucza; -1 oznacza brak limitu |
keys[].used_quota | number | Wykorzystany limit klucza; -1 oznacza brak limitu |
daily_quota | object | Dzienne zestawienie użycia (tylko gdy ustawiono start_date i end_date) |
daily_quota[date] | array | Wpisy użycia dla poszczególnych kluczy w danym dniu |
daily_quota[date][].token_name | string | Nazwa klucza API |
daily_quota[date][].quota_used | number | Użycie tego klucza w tym dniu (USD) |
daily_quota[date][].request_count | integer | Liczba żądań dla tego klucza w tym dniu |
Przykłady kodu
Zapytanie o saldo konta:
curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY"
Przykład odpowiedzi
{
"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
}
]
}
Przykład dziennego zestawienia
Zapytanie o dzienne użycie dla zakresu dat:
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
}
]
}
}
