Kueri saldo dan penggunaan

CometAPI menyediakan dua cara untuk memeriksa saldo akun dan penggunaan: CometAPI CLI dan API layanan kueri di query.cometapi.com. Jika Anda menggunakan Workspace, lihat Kelola tim dengan CometAPI Workspace untuk memahami Organization Credits bersama dan peran penagihan.

CometAPI CLI

Periksa saldo Anda dari terminal dengan satu perintah. Lihat ikhtisar CometAPI CLI untuk instalasi.

cometapi balance

Tambahkan --source token untuk detail per-key:

cometapi balance --source token

Lihat referensi perintah untuk semua opsi yang tersedia.

API layanan kueri

GET https://query.cometapi.com/user/quota Mengembalikan saldo tingkat akun, penggunaan kumulatif, jumlah total request, dan detail kuota per key. Endpoint ini menggunakan layanan kueri terpisah di query.cometapi.com dan melakukan autentikasi melalui parameter kueri key alih-alih Bearer Token.

Gunakan API key khusus untuk kueri saldo. Jika Anda ingin membatasi eksposur, nonaktifkan Unlimited Quota dan tetapkan batas kredit positif terkecil yang diizinkan oleh dashboard.

Parameter request

Parameter	Type	Required	Description
`key`	string	Yes	API key CometAPI Anda
`start_date`	string	No	Tanggal mulai untuk rincian harian (format `YYYY-MM-DD`)
`end_date`	string	No	Tanggal akhir untuk rincian harian (format `YYYY-MM-DD`)

Saat start_date dan end_date diberikan, respons akan menyertakan field daily_quota dengan penggunaan per key yang diuraikan per hari.

Field respons

Field	Type	Description
`username`	string	Username
`total_quota`	number	Saldo akun saat ini (USD)
`total_used_quota`	number	Penggunaan kumulatif (USD)
`request_count`	integer	Jumlah total request
`keys`	array	Detail kuota per key
`keys[].name`	string	Nama API key
`keys[].remain_quota`	number	Sisa kuota key; `-1` berarti tidak terbatas
`keys[].used_quota`	number	Kuota key yang digunakan; `-1` berarti tidak terbatas
`daily_quota`	object	Rincian penggunaan harian (hanya saat `start_date` dan `end_date` disetel)
`daily_quota[date]`	array	Entri penggunaan per key untuk tanggal tersebut
`daily_quota[date][].token_name`	string	Nama API key
`daily_quota[date][].quota_used`	number	Penggunaan untuk key tersebut pada tanggal itu (USD)
`daily_quota[date][].request_count`	integer	Jumlah request untuk key tersebut pada tanggal itu

Contoh kode

Kueri saldo akun:

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

Contoh respons

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

Contoh rincian harian

Kueri penggunaan harian untuk rentang tanggal:

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

Respons menyertakan field tingkat atas yang sama ditambah 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
      }
    ]
  }
}

Mulai di sini

Panduan cepat API model

Panduan inti API

Pustaka

Kesalahan

Harga dan penagihan

Dukungan

CometAPI CLI

API layanan kueri

Parameter request

Field respons

Contoh kode

Contoh respons

Contoh rincian harian

​CometAPI CLI

​API layanan kueri

​Parameter request

​Field respons

​Contoh kode

​Contoh respons

​Contoh rincian harian

CometAPI CLI

API layanan kueri

Parameter request

Field respons

Contoh kode

Contoh respons

Contoh rincian harian