Langsung ke konten utama

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 menyediakan dua cara untuk memeriksa saldo akun dan penggunaan: CometAPI CLI dan API layanan kueri di query.cometapi.com.

​
CometAPI CLI

Cara tercepat untuk memeriksa saldo Anda dari terminal. 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, total jumlah permintaan, dan detail kuota per-key. Endpoint ini menggunakan layanan kueri terpisah di query.cometapi.com dan melakukan autentikasi melalui parameter kueri key, bukan Bearer Token.
Buat API key khusus untuk kueri saldo dan atur kuotanya ke 0 (izin hanya-kueri). Bahkan jika key tersebut bocor, key itu tidak dapat digunakan untuk permintaan model.

​
Parameter permintaan

ParameterTypeRequiredDescription
keystringYesAPI key CometAPI Anda
start_datestringNoTanggal mulai untuk rincian harian (format YYYY-MM-DD)
end_datestringNoTanggal 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

FieldTypeDescription
usernamestringUsername
total_quotanumberSaldo akun saat ini (USD)
total_used_quotanumberPenggunaan kumulatif (USD)
request_countintegerTotal jumlah permintaan
keysarrayDetail kuota per-key
keys[].namestringNama API key
keys[].remain_quotanumberSisa kuota key; -1 berarti tanpa batas
keys[].used_quotanumberKuota key yang telah digunakan; -1 berarti tanpa batas
daily_quotaobjectRincian penggunaan harian (hanya saat start_date dan end_date ditetapkan)
daily_quota[date]arrayEntri penggunaan per-key untuk tanggal tersebut
daily_quota[date][].token_namestringNama API key
daily_quota[date][].quota_usednumberPenggunaan untuk key tersebut pada tanggal itu (USD)
daily_quota[date][].request_countintegerJumlah permintaan untuk key tersebut pada tanggal itu

​
Contoh kode

Kueri saldo akun: 
curl `https://query.cometapi.com/user/quota?key=${process.env.COMETAPI_KEY}`

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