Saldo en gebruik opvragen

CometAPI biedt twee manieren om accountsaldo en gebruik te controleren: de CometAPI CLI en de query service API op query.cometapi.com. Als je een Workspace gebruikt, zie Een team beheren met CometAPI Workspace voor informatie over gedeelde Organization Credits en factureringsrollen.

CometAPI CLI

Controleer je saldo vanuit de terminal met één opdracht. Zie Overzicht van de CometAPI CLI voor installatie.

cometapi balance

Voeg --source token toe voor details per sleutel:

cometapi balance --source token

Zie de opdrachtenreferentie voor alle beschikbare opties.

Query service API

GET https://query.cometapi.com/user/quota Geeft het accountsaldo, cumulatief gebruik, het totale aantal requests en quota-details per key terug. Dit endpoint gebruikt een aparte queryservice op query.cometapi.com en authenticatie verloopt via de queryparameter key in plaats van via een Bearer Token.

Gebruik een aparte API key voor saldocontroles. Als je de blootstelling wilt beperken, schakel dan Unlimited Quota uit en stel de kleinste positieve kredietlimiet in die door het dashboard is toegestaan.

Requestparameters

Parameter	Type	Required	Description
`key`	string	Yes	Je CometAPI API key
`start_date`	string	No	Startdatum voor dagelijkse uitsplitsing (indeling `YYYY-MM-DD`)
`end_date`	string	No	Einddatum voor dagelijkse uitsplitsing (indeling `YYYY-MM-DD`)

Wanneer start_date en end_date zijn opgegeven, bevat de response een veld daily_quota met gebruik per key, uitgesplitst per dag.

Responsevelden

Field	Type	Description
`username`	string	Gebruikersnaam
`total_quota`	number	Huidig accountsaldo (USD)
`total_used_quota`	number	Cumulatief gebruik (USD)
`request_count`	integer	Totaal aantal requests
`keys`	array	Quota-details per key
`keys[].name`	string	Naam van de API key
`keys[].remain_quota`	number	Resterend quota van de key; `-1` betekent onbeperkt
`keys[].used_quota`	number	Verbruikt quota van de key; `-1` betekent onbeperkt
`daily_quota`	object	Dagelijkse gebruiksuitsplitsing (alleen wanneer `start_date` en `end_date` zijn ingesteld)
`daily_quota[date]`	array	Gebruiksoverzichten per key voor die datum
`daily_quota[date][].token_name`	string	Naam van de API key
`daily_quota[date][].quota_used`	number	Gebruik voor die key op die datum (USD)
`daily_quota[date][].request_count`	integer	Aantal requests voor die key op die datum

Codevoorbeelden

Accountsaldo opvragen:

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

Responsevoorbeeld

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

Voorbeeld van dagelijkse uitsplitsing

Dagelijks gebruik voor een datumbereik opvragen:

curl "https://query.cometapi.com/user/quota?key=$COMETAPI_KEY&start_date=2026-04-13&end_date=2026-04-14"

De response bevat dezelfde velden op het hoogste niveau plus 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
      }
    ]
  }
}

Begin hier

Snelstarts voor model-API's

Kernhandleidingen voor de API

Bibliotheken

Fouten

Prijzen en facturering

Ondersteuning

CometAPI CLI

Query service API

Requestparameters

Responsevelden

Codevoorbeelden

Responsevoorbeeld

Voorbeeld van dagelijkse uitsplitsing

​CometAPI CLI

​Query service API

​Requestparameters

​Responsevelden

​Codevoorbeelden

​Responsevoorbeeld

​Voorbeeld van dagelijkse uitsplitsing

CometAPI CLI

Query service API

Requestparameters

Responsevelden

Codevoorbeelden

Responsevoorbeeld

Voorbeeld van dagelijkse uitsplitsing