Langganan (paket)

Paket langganan (opsional) memberi kuota jendela untuk model tertentu, di luar saldo prabayar biasa. Selama kuota jendela masih ada, request memakai kuota itu, bukan saldo. Bagian ini menjelaskan mekanismenya. Untuk gambaran umum cara bayar lihat Penagihan & Rupiah.

Jendela kuota

Setiap paket punya sampai tiga jendela kuota rolling, masing-masing opsional (nol berarti tanpa batas untuk jendela itu):

Jendela	Fungsi
5 jam	jendela terpendek, membatasi burst jangka pendek
Mingguan	jendela menengah
Bulanan	jendela terpanjang, plafon anti-penyalahgunaan

Kuota diukur dalam biaya nyata (Rupiah), bukan jumlah request: request yang lebih mahal (model lebih besar, konteks lebih panjang) memakai kuota lebih banyak. Jendela bersifat rolling (dihitung ulang sejak aktivasi, bukan dari awal bulan kalender) dan digulirkan saat dibaca, jadi tidak butuh cron terpisah untuk mereset.

Saat sebuah jendela habis, dua sakelar akun menentukan yang terjadi berikutnya:

• PAYG (bayar-sesuai-pakai): request lanjut ditagih dari saldo biasa.
• Rute gratis: request dialihkan ke model gratis (kenari-free), tanpa biaya.

Tanpa sakelar yang aktif, request ditolak dengan HTTP 429 plan_limit_reached sampai jendela berikutnya bergulir. Atur sakelar ini dan ganti paket dari dashboard.

Kuota untuk agent melalui API

Langganan menampilkan nama paket dan pemakaian katalog 30 hari dalam Rupiah. Limit Paket di Pemakaian menampilkan sisa jendela 5 jam, mingguan, dan bulanan sebagai persentase beserta waktu reset. Agent yang memegang key kn- dapat memakai GET /v1/account/quota atau tool MCP kenari_quota untuk membaca nama paket aktif, pemakaian dan sisa setiap jendela terbatas dalam Rupiah, waktu reset, serta kupon aktif.

plan bernilai null saat tidak ada paket yang dapat dipakai. Jendela tanpa batas tidak ditampilkan, dan kupon aktif ditampilkan terpisah dari jendela paket. Key yang dibagikan ditolak dengan HTTP 403. Untuk cara memakai tool MCP, lihat Untuk agen AI.

Kuota harian model gratis

Terpisah dari jendela kuota berbayar di atas, setiap paket juga bisa membawa kuota harian sendiri untuk model :free (free_daily_quota). Kartu paket menampilkan angkanya saat paket menyetel nilai sendiri. Tanpa itu berlaku nilai bawaan langganan. Kuota ini tidak memakai jatah jendela kuota berbayar: keduanya dihitung dan direset sendiri-sendiri. Mekanisme kuota harian dan tingkatannya dijelaskan di Penagihan & Rupiah.

Model tercakup

Setiap paket mencakup daftar model tertentu (scope_models). Request ke model yang tercakup memakai jendela kuota di atas. Request ke model di luar daftar itu jatuh langsung ke saldo PAYG biasa, terlepas dari sisa kuota jendela.

Cache gratis

Sebagian model, pada paket tertentu, membebaskan token cache-read dari pemakaian kuota (token output dan token input segar tetap memakai kuota seperti biasa). Ini murni pengganda kuota, bukan potongan harga: harga jual katalog tidak berubah, request PAYG atau saldo tetap membayar penuh seperti biasa. Cache gratis hanya berlaku saat model tersebut tercakup DAN terdaftar di daftar cache-gratis paket yang membiayai request itu. Satu model bisa gratis di satu paket dan tidak di paket lain.

Kode

Semua kode masuk lewat satu kotak yang sama. Tidak ada kode yang ditolak karena “salah halaman”: kotak itu ada di halaman Saldo, halaman Langganan, dan halaman Promo, dan ketiganya menerima semua jenis kode.

Setelah kode dicek, yang terjadi berikutnya ditentukan oleh isi kodenya, bukan oleh halaman tempat kamu mengetiknya:

Isi kode	Yang terjadi
Potongan harga paket atau trial	Kode tersimpan sebagai spanduk “Kode aktif”, kamu diantar ke halaman Langganan, dan kartu paket yang memenuhi syarat langsung menampilkan harga setelah potongan
Bonus top up	Kode tersimpan, kamu diantar ke halaman Saldo, dan nominal bonus terlihat saat kamu mengetik jumlah
Saldo langsung, akses paket, atau kode referral	Kotak menampilkan isi kodenya lebih dulu, lalu menunggu kamu menekan tombol konfirmasi. Kode jenis ini sekali pakai dan tidak bisa dibatalkan, jadi tidak pernah dijalankan diam-diam
Kode atribusi	Kode ini sudah tercatat saat kamu mendaftar, jadi kotak hanya memberi tahu dan tidak meminta apa pun
Kampanye tugas	Kotak mengarahkan ke kartu kampanyenya di halaman Promo, tempat formulir pengajuan berada

Spanduk “Kode aktif” bertahan saat kamu berpindah halaman, dan punya tombol hapus kalau kamu berubah pikiran. Satu kode aktif dalam satu waktu: memasukkan kode baru menggantikan yang lama.

Tautan berbagi kode berbentuk kenari.id/code/KODE. Membukanya saat sudah masuk akan langsung memeriksa kode dan membawa kamu ke tempat kode itu bisa dipakai. Membukanya saat belum punya akun akan mengarah ke pendaftaran, dan kodenya terpasang begitu akun dibuat.

Cashback referral

Saat program referral aktif, sebagian paket memberi cashback persen dari semua belanja teman yang kamu ajak, termasuk pemakaian API, pembelian langganan, dan layanan lain, sampai batas bulanan tertentu. Cashback dihitung per hari dan cair sebagai saldo sekitar 3 hari setelah belanjanya terjadi. Teman yang kamu ajak juga mendapat cashback yang sama atas belanjanya sendiri. Detail, riwayat cashback, dan kode referral ada di kartu Undang teman pada halaman Promo. Baris cashback pada tabel paket di bawah hanya muncul saat program ini aktif untuk paket tersebut.

Daftar paket

Data paket di bawah diambil langsung dari GET /api/plans (harga, jendela kuota, model tercakup, cache gratis, cashback bila aktif) dan GET /api/public/pricing (tarif normal model untuk baris cache gratis), jadi selalu sama dengan yang berlaku saat ini.

Paket

PAYG

Memuat paket...