Sprawdzanie salda i użycia

CometAPI udostępnia dwa sposoby sprawdzania salda konta i użycia: CometAPI CLI oraz API usługi zapytań pod adresem query.cometapi.com. Jeśli korzystasz z Workspace, zobacz Zarządzanie zespołem za pomocą CometAPI Workspace, aby poznać współdzielone Organization Credits i role rozliczeniowe.

CometAPI CLI

Sprawdź saldo z terminala za pomocą jednej komendy. Informacje o instalacji znajdziesz w przeglądzie CometAPI CLI.

cometapi balance

Dodaj --source token, aby wyświetlić szczegóły dla poszczególnych kluczy:

cometapi balance --source token

Wszystkie dostępne opcje znajdziesz w dokumentacji komend.

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.

Do zapytań o saldo używaj dedykowanego klucza API. Jeśli chcesz ograniczyć ekspozycję, wyłącz Unlimited Quota i ustaw najmniejszy dodatni limit środków dozwolony w panelu.

Parametry żądania

Parameter	Type	Required	Description
`key`	string	Yes	Twój klucz API CometAPI
`start_date`	string	No	Data początkowa dla dziennego podziału (`YYYY-MM-DD` format)
`end_date`	string	No	Data 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

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	Dzienny podział użycia (tylko gdy ustawiono `start_date` i `end_date`)
`daily_quota[date]`	array	Wpisy użycia dla poszczególnych kluczy dla tej daty
`daily_quota[date][].token_name`	string	Nazwa klucza API
`daily_quota[date][].quota_used`	number	Użycie dla tego klucza w tej dacie (USD)
`daily_quota[date][].request_count`	integer	Liczba żądań dla tego klucza w tej dacie

Przykłady kodu

Zapytanie o saldo konta:

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

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

Zacznij tutaj

Szybki start z API modeli

Podstawowe przewodniki po API

Biblioteki

Błędy

Ceny i rozliczenia

Wsparcie

CometAPI CLI

API usługi zapytań

Parametry żądania

Pola odpowiedzi

Przykłady kodu

Przykład odpowiedzi

Przykład dziennego podziału

​CometAPI CLI

​API usługi zapytań

​Parametry żądania

​Pola odpowiedzi

​Przykłady kodu

​Przykład odpowiedzi

​Przykład dziennego podziału

CometAPI CLI

API usługi zapytań

Parametry żądania

Pola odpowiedzi

Przykłady kodu

Przykład odpowiedzi

Przykład dziennego podziału