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
Request
Section titled “Request”Endpoint ini tidak menerima parameter query maupun body. Endpoint ini membutuhkan API key di header Authorization.
| Header | Wajib | Keterangan |
|---|---|---|
Authorization | ya | Bearer kn-.... API key dibagikan dan key yang dibatasi ditolak. Lihat Autentikasi & API key. |
Response
Section titled “Response”Response berisi tiga field, plan, coupon, dan alert_pct. plan dan coupon masing-masing berupa objek, atau null kalau tidak berlaku.
| Field | Tipe | Keterangan |
|---|---|---|
plan | objek atau null | Paket aktif kamu. null kalau kamu belum pernah berlangganan, paket sudah berakhir, atau paket tidak lagi ditawarkan. |
plan.name | string | Nama paket. |
plan.windows | objek | Jendela 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_rp | integer | Plafon jendela ini dalam Rupiah utuh, dibulatkan ke bawah. |
plan.windows.<key>.used_rp | integer | Rupiah yang terpakai di jendela ini, dibulatkan ke atas. |
plan.windows.<key>.remaining_rp | integer | Rupiah yang tersisa di jendela ini, dibulatkan ke bawah dan tidak pernah di bawah 0. |
plan.windows.<key>.used_frac | number | Pecahan plafon yang terpakai, dari 0 sampai 1 dengan 4 desimal. |
plan.windows.<key>.resets_at | string | Waktu jendela rolling ini direset, dalam RFC 3339 UTC. |
coupon | objek atau null | Kupon aktif. null kalau kamu tidak punya atau kupon sudah kedaluwarsa. Kupon dilaporkan terpisah dari paket, jadi kamu bisa punya kupon tanpa paket. |
coupon.name | string | Nama kupon. |
coupon.used_rp | integer | Rupiah yang terpakai dari kupon, dibulatkan ke atas. |
coupon.remaining_rp | integer atau null | Rupiah 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_at | string | Waktu kupon kedaluwarsa, dalam RFC 3339 UTC. |
coupon.scope_models | array of string | Id model yang ditanggung kupon. |
alert_pct | integer | Ambang 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.
Contoh
Section titled “Contoh”curl https://kenari.id/v1/account/quota \ -H "Authorization: Bearer $KENARI_API_KEY"Python
Section titled “Python”import osimport 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 "")JavaScript
Section titled “JavaScript”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.
Penagihan
Section titled “Penagihan”Membaca kuota kamu gratis. Lihat Cara penagihan.
Header pada balasan chat
Section titled “Header pada balasan chat”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.
| Status | Kode | Kapan |
|---|---|---|
| 401 | Tidak ada | Key tidak ada, tidak valid, atau sudah kedaluwarsa. Body-nya pesan teks singkat, bukan JSON. |
| 403 | shared_key_not_allowed | Key adalah API key dibagikan. API key dibagikan tidak bisa membaca kuota pemiliknya. |
| 403 | restricted_key_not_allowed | Key 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. |
| 500 | internal_error | Pembacaan kuota gagal di kenari. Coba lagi sekali. |
Lihat Error untuk format error dan kode lainnya.