Lewati ke konten
kenari.

Kuota akun

Baca sisa kuota paket dan anggaran kupon kamu dalam Rupiah utuh, supaya agen atau skrip bisa memeriksanya sebelum memulai pekerjaan yang panjang. Endpoint ini khusus kenari dan tidak punya padanan di OpenAI maupun Anthropic.

GET /v1/account/quota

Endpoint ini tidak menerima parameter query maupun body. Endpoint ini membutuhkan API key di header Authorization.

HeaderWajibKeterangan
AuthorizationyaBearer kn-.... API key dibagikan dan key yang dibatasi ditolak. Lihat Autentikasi & API key.

Response berisi tiga field, plan, coupon, dan alert_pct. plan dan coupon masing-masing berupa objek, atau null kalau tidak berlaku.

FieldTipeKeterangan
planobjek atau nullPaket aktif kamu. null kalau kamu belum pernah berlangganan, paket sudah berakhir, atau paket tidak lagi ditawarkan.
plan.namestringNama paket.
plan.windowsobjekJendela kuota yang punya plafon. Nama field yang mungkin muncul adalah five_hour, week, dan month. Jendela tanpa plafon tidak ditampilkan, jadi objek ini bisa kosong.
plan.windows.<key>.budget_rpintegerPlafon jendela ini dalam Rupiah utuh, dibulatkan ke bawah.
plan.windows.<key>.used_rpintegerRupiah yang terpakai di jendela ini, dibulatkan ke atas.
plan.windows.<key>.remaining_rpintegerRupiah yang tersisa di jendela ini, dibulatkan ke bawah dan tidak pernah di bawah 0.
plan.windows.<key>.used_fracnumberPecahan plafon yang terpakai, dari 0 sampai 1 dengan 4 desimal.
plan.windows.<key>.resets_atstringWaktu jendela rolling ini direset, dalam RFC 3339 UTC.
couponobjek atau nullKupon aktif. null kalau kamu tidak punya atau kupon sudah kedaluwarsa. Kupon dilaporkan terpisah dari paket, jadi kamu bisa punya kupon tanpa paket.
coupon.namestringNama kupon.
coupon.used_rpintegerRupiah yang terpakai dari kupon, dibulatkan ke atas.
coupon.remaining_rpinteger atau nullRupiah yang tersisa di kupon: anggaran yang dibulatkan ke bawah menjadi Rupiah utuh, dikurangi used_rp, dan tidak pernah di bawah 0. null kalau kupon tidak punya batas pengeluaran.
coupon.expires_atstringWaktu kupon kedaluwarsa, dalam RFC 3339 UTC.
coupon.scope_modelsarray of stringId model yang ditanggung kupon.
alert_pctintegerAmbang peringatan kuotamu: 50, 80, atau 90. Bandingkan dengan used_frac * 100 untuk tahu kapan peringatan kuota dikirim. Kamu mengaturnya di Pengaturan, Notifikasi. Lihat Notifikasi.
{
"plan": {
"name": "Indie",
"windows": {
"week": {
"budget_rp": 75000,
"used_rp": 12000,
"remaining_rp": 63000,
"used_frac": 0.16,
"resets_at": "2026-10-13T07:12:00Z"
},
"month": {
"budget_rp": 300000,
"used_rp": 12000,
"remaining_rp": 288000,
"used_frac": 0.04,
"resets_at": "2026-10-30T07:12:00Z"
}
}
},
"coupon": null,
"alert_pct": 80
}

Untuk cara kerja jendela, kupon, dan model tercakup, lihat Langganan.

Terminal window
curl https://kenari.id/v1/account/quota \
-H "Authorization: Bearer $KENARI_API_KEY"
import os
import requests
response = requests.get(
"https://kenari.id/v1/account/quota",
headers={"Authorization": f"Bearer {os.environ['KENARI_API_KEY']}"},
)
response.raise_for_status()
quota = response.json()
for name, window in (quota["plan"] or {}).get("windows", {}).items():
alert = window["used_frac"] * 100 >= quota["alert_pct"]
print(name, window["remaining_rp"], window["used_frac"], window["resets_at"], "ALERT" if alert else "")
const response = await fetch("https://kenari.id/v1/account/quota", {
headers: { Authorization: `Bearer ${process.env.KENARI_API_KEY}` },
});
if (!response.ok) throw new Error(await response.text());
const quota = await response.json();
for (const [name, window] of Object.entries(quota.plan?.windows ?? {})) {
const alert = window.used_frac * 100 >= quota.alert_pct;
console.log(name, window.remaining_rp, window.used_frac, window.resets_at, alert ? "ALERT" : "");
}

Tool MCP kenari_quota mengembalikan data paket dan kupon yang sama sebagai teks biasa. Lihat Server MCP.

Membaca kuota kamu gratis. Lihat Cara penagihan.

Balasan chat yang sukses juga bisa membawa pecahan sisa tiap jendela di header x-kenari-plan-remaining, jadi agen tidak perlu panggilan terpisah. Lihat Notifikasi.

StatusKodeKapan
401Tidak adaKey tidak ada, tidak valid, atau sudah kedaluwarsa. Body-nya pesan teks singkat, bukan JSON.
403shared_key_not_allowedKey adalah API key dibagikan. API key dibagikan tidak bisa membaca kuota pemiliknya.
403restricted_key_not_allowedKey punya pembatasan model, batas biaya, atau batas token. Pakai key tanpa pembatasan dari akun itu sendiri. Pemakaian key itu sendiri tetap bisa dibaca dari GET /v1/usage.
500internal_errorPembacaan kuota gagal di kenari. Coba lagi sekali.

Lihat Error untuk format error dan kode lainnya.