Przejdź do głównej treści

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.

CometAPI udostępnia dwa sposoby sprawdzania salda konta i użycia: CometAPI CLI oraz API usługi query pod adresem query.cometapi.com.

​
CometAPI CLI

Najszybszy sposób na sprawdzenie salda z poziomu terminala. Informacje o instalacji znajdziesz w przeglądzie CometAPI CLI. 
cometapi balance
Dodaj --source token, aby uzyskać szczegóły dla poszczególnych kluczy: 
cometapi balance --source token
Wszystkie dostępne opcje znajdziesz w referencji poleceń.

​
Query service API

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 osobnej usługi query pod adresem query.cometapi.com i uwierzytelnia się 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 go użyć do żądań modelu.

​
Parametry żądania

ParameterTypeRequiredDescription
keystringYesTwój klucz API CometAPI
start_datestringNoData początkowa dla dziennego podziału (YYYY-MM-DD format)
end_datestringNoData końcowa dla dziennego podziału (YYYY-MM-DD format)
Gdy podane są start_date i end_date, odpowiedź zawiera pole daily_quota z użyciem dla poszczególnych kluczy w podziale na dni.

​
Pola odpowiedzi

FieldTypeDescription
usernamestringNazwa użytkownika
total_quotanumberBieżące saldo konta (USD)
total_used_quotanumberSkumulowane użycie (USD)
request_countintegerŁączna liczba żądań
keysarraySzczegóły limitów dla poszczególnych kluczy
keys[].namestringNazwa klucza API
keys[].remain_quotanumberPozostały limit klucza; -1 oznacza brak limitu
keys[].used_quotanumberWykorzystany limit klucza; -1 oznacza brak limitu
daily_quotaobjectDzienne zestawienie użycia (tylko gdy ustawiono start_date i end_date)
daily_quota[date]arrayWpisy użycia dla poszczególnych kluczy w danym dniu
daily_quota[date][].token_namestringNazwa klucza API
daily_quota[date][].quota_usednumberUżycie tego klucza w tym dniu (USD)
daily_quota[date][].request_countintegerLiczba żądań dla tego klucza w tym dniu

​
Przykłady kodu

Zapytanie o saldo konta: 
curl `https://query.cometapi.com/user/quota?key=${process.env.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 podziału

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"
Odpowiedź zawiera te same pola najwyższego poziomu oraz 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
      }
    ]
  }
}