Lewati ke konten
kenari.

Langganan

Paket langganan memberi kamu kuota pemakaian chat pada daftar model tertentu dengan harga bulanan. Selama kuota masih ada, request ke model itu memakai kuota dan saldo kamu tidak tersentuh. Halaman ini membahas cara kuota diukur, yang terjadi saat kuota habis, dan endpoint yang tidak pernah ditanggung paket. Untuk soal uang secara umum, lihat Cara penagihan.

Setiap paket punya sampai tiga jendela kuota. Jendela tanpa plafon berarti tanpa batas.

JendelaPanjang
5 jam5 jam
Mingguan7 hari
Bulanan30 hari

Kuota diukur dalam Rupiah dengan harga normal setiap model, bukan dalam jumlah request. Request yang mahal, misalnya model besar dengan prompt panjang, menghabiskan kuota lebih banyak. Request lolos hanya kalau setiap jendela yang punya plafon masih memiliki sisa kuota.

Jendela bersifat rolling dan tidak mengikuti kalender. Setiap jendela mulai saat siklus paketmu mulai, lalu direset sesuai durasi masing-masing. Jendela bulanan dan paketmu mulai bersamaan, jadi reset bulanan biasanya jatuh di hari paketmu berakhir. Dashboard lalu hanya menampilkan tanggal berakhir paket, dan kuota terisi lagi hanya kalau paket diperpanjang. Memperpanjang paket yang sama lebih awal hanya memperpanjang siklus dan tidak mengubah jadwal reset, jadi reset bulanan lalu tampil dengan tanggalnya sendiri. Naik ke paket yang lebih tinggi memulai jendela baru, dan sisa hari paket lama dipotongkan dari harga paket baru. Memulai siklus baru mereset setiap jendela seketika.

Setiap paket mencantumkan model yang ditanggungnya. Request ke model tercakup memakai kuota. Request ke model lain ditagih ke saldo kamu sebagai PAYG, berapa pun kuota yang tersisa. Daftar terbaru setiap paket ada di tabel di akhir halaman ini.

Paket juga bisa membawa kuota harian sendiri untuk model :free, terpisah dari jendela kuota. Lihat Model gratis.

Pilih paket di halaman Langganan dan bayar dengan QRIS, kripto, atau saldo. Paket berlaku 30 hari sejak pembayaran.

Pembayaran QRIS atau kripto diperiksa lagi saat selesai. Kalau paketmu atau harga paketnya berubah selama itu, atau kode promo pada tagihan sudah terpakai, paket tidak diaktifkan. Jumlah yang kamu bayar masuk ke saldo dan kamu mendapat notifikasi. Pilih paketnya lagi untuk membelinya dengan harga terbaru. Kode promo yang masih ada di tagihan yang belum dibayar tidak bisa dipakai untuk pembayaran dari saldo sampai kamu menyelesaikan atau membatalkan tagihan itu.

Kartu status di bagian atas halaman Langganan menunjukkan kapan paketmu berakhir. Aktifkan Perpanjang otomatis dari saldo dan kartu menampilkan tanggal perpanjangan serta harga yang akan diambil dari saldomu. Kalau saldomu kurang, kartu menunjukkan berapa kekurangannya, beserta tautan Isi saldo.

Saat siklus berakhir, kenari mengambil harga paket dari saldomu dan memulai 30 hari berikutnya. Perpanjang otomatis tidak membagi harga antara saldo dan QRIS atau kripto, jadi saldo harus menutup seluruhnya. Kalau tidak cukup, atau paketnya sudah tidak dijual, paket berakhir, perpanjang otomatis mati, dan kamu mendapat notifikasi. Top up lalu pilih paket lagi untuk melanjutkan.

Naik ke paket yang lebih tinggi memulai siklus baru 30 hari sejak hari upgrade. Sisa waktu paket lama tidak ditambahkan ke siklus baru. Nilai sisa paket lama dihitung jadi potongan harga paket baru, dan besarnya terlihat di halaman Langganan sebelum kamu membayar.

Kalau kamu sampai di batas lebih cepat, kamu bisa membeli siklus baru dari paketmu saat ini tanpa menunggu. Di halaman Langganan, kartu Mulai siklus baru menampilkan harga paket per siklus. Pilih Mulai sekarang. Sebuah dialog menunjukkan harga, hari yang hangus, dan saldomu setelah pembayaran, lalu kamu mengonfirmasi dengan tombol pembayarannya.

  • Kamu membayar harga penuh paketmu saat ini dari saldo. QRIS dan kripto tidak tersedia.
  • Siklus 30 hari yang baru dimulai sekarang. Jendela 5 jam, mingguan, dan bulanan semuanya kembali ke nol.
  • Sisa hari di siklus lama hangus. Dialognya menunjukkan berapa harinya.
  • Kalau saldomu kurang, kartu menunjukkan jumlah kekurangannya beserta tautan Isi saldo.

Ini hanya berlaku untuk paket berbayar yang masih dijual. Siklus trial, kupon, dan paket yang sudah tidak dijual tidak bisa dimulai ulang, dan dashboard memberi tahu hal itu. Paket dari hadiah langganan yang sudah aktif adalah siklus berbayar dan bisa dimulai ulang. Lihat Hadiah langganan. Kalau kamu masih punya reset gratis, Reset kuota sendiri dengan tombol Reset sekarang ditawarkan lebih dulu, dan kartunya tidak muncul selama kamu masih punya reset. Tabel perbandingan paket mencantumkan harga tiap paket di baris Mulai siklus baru.

Memulai siklus baru adalah aksi di dashboard. Tidak ada panggilan API untuk itu, dan API key tidak bisa melakukannya.

Saat salah satu jendela yang punya plafon habis, dua pengaturan akun menentukan yang terjadi pada request ke model yang tercakup oleh paketmu. Kamu bisa menemukannya di halaman Langganan, di bagian Saat kuota habis. Keduanya nonaktif secara bawaan.

Lanjut pakai saldoAlihkan ke model gratisYang dilakukan request
AktifNonaktifLanjut, ditagih ke saldo. Batas pengeluaran PAYG di Cara penagihan tetap berlaku.
AktifAktifLanjut, ditagih ke saldo. Model gratis dipakai hanya saat pilihan saldo dimatikan.
NonaktifAktifDialihkan ke model gratis tanpa biaya.
NonaktifNonaktifDitolak dengan HTTP 429 dan kode plan_limit_reached sampai jendela direset.
{
"error": {
"message": "...",
"type": "plan_limit_reached",
"param": null,
"code": "plan_limit_reached"
}
}

message menjelaskan keadaannya untuk manusia. Gunakan code untuk menentukan penanganan error. Lihat Error untuk formatnya.

Setelah paket berakhir, pemakaian ditagih ke saldo kamu sebagai PAYG, dan batas pengeluaran PAYG di Cara penagihan tetap berlaku. Satu-satunya pengecualian adalah saat Alihkan ke model gratis aktif dan Lanjut pakai saldo nonaktif. Saat itu, request ke model yang dulu ditanggung paket dialihkan ke model gratis tanpa biaya. Model yang hanya untuk pelanggan tetap membutuhkan paket aktif, seperti dijelaskan di Model khusus pelanggan.

Endpoint yang tidak pernah ditanggung paket

Section titled “Endpoint yang tidak pernah ditanggung paket”

Paket hanya menanggung chat. Endpoint berikut selalu dibayar dari saldo, bahkan saat kuota masih ada:

  • Gambar, text to speech, transkripsi, musik, dan video
  • Embeddings, rerank, moderasi, dan System One
  • OCR, yaitu engine ocr di Baca dokumen dan /v1/ocr

Dokumen yang dilampirkan ke request chat dan dibaca dengan cara bawaan adalah token input biasa, jadi paket yang mencakup modelnya juga mencakup dokumen itu.

Endpoint ini, dan model apa pun yang tidak ditanggung paket maupun kupon, selalu ditagih ke saldo kamu, apa pun dua pengaturanmu. Itu berlaku saat kuota masih ada, setelah jendela habis, dan setelah paket berakhir. Akun tanpa paket dan tanpa kupon membayar dari saldo seperti biasa.

Pencarian web dan pengambilan halaman bekerja berbeda. Setiap paket menyertakan jatah panggilan harian, dihitung per hari UTC. Pencarian dan pengambilan halaman berbagi jatah itu, dan panggilan di dalam jatah itu gratis. Di atas jatah itu, setiap panggilan ditagih ke saldo, apa pun dua pengaturanmu. Pencarian X bukan bagian dari paket mana pun. Pencarian X selalu ditagih ke saldo, apa pun dua pengaturan tadi. Lihat Server tools dan Pencarian web & X.

Untuk sebagian model pada paket tertentu, token cache tidak memakai kuota. Token cache read dan cache write gratis, sedangkan token Input yang tidak berasal dari cache dan token Output tetap dihitung seperti biasa. Tabel paket di akhir halaman ini mencantumkan modelnya di bawah Cache gratis.

Cache gratis berlaku saat model tercakup oleh paket dan terdaftar di daftar cache gratis paket itu. Satu model bisa mendapat fasilitas cache gratis di satu paket dan tidak di paket lain. Cache gratis juga berlaku untuk tagihan saldo setelah jendela habis, saat Lanjut pakai saldo aktif. Model yang tidak tercakup paket ditagih penuh. Halaman Pemakaian menunjukkan berapa banyak yang dihemat cache gratis.

Sebuah kode bisa memberi akses paket untuk waktu terbatas. Pemberian itu disebut kupon. Kupon tampil sebagai Kupon aktif di halaman Langganan dan menanggung model yang dicantumkannya. Request ke model yang ditanggung dibayar dari kupon, sama seperti paket membayar dari kuota, jadi tidak butuh saldo, dan kupon dipakai lebih dulu daripada kuota paket. Saat anggaran kupon habis, paket aktif mengambil alih untuk model yang ditanggungnya. Tanpa paket, request mengikuti aturan untuk paket yang sudah berakhir di Saat kuota habis. Cara kerja kode ada di Kode & referral, dan field kupon ada di Kuota akun.

Sebagian model hanya untuk akun dengan paket aktif. Akun lain mendapat HTTP 403 dengan kode subscribers_only, di setiap endpoint yang menerima model itu, termasuk endpoint media.

GET /v1/account/quota mengembalikan nama paket, sisa Rupiah di setiap jendela, dan kupon aktif. Tool MCP kenari_quota mengembalikan data yang sama sebagai teks. Lihat Kuota akun dan Server MCP. Di dashboard, halaman Pemakaian menampilkan jendela yang sama dalam persentase beserta waktu reset.

Paket di bawah dibaca langsung dari GET /api/plans dan GET /api/public/pricing, jadi selalu sama dengan yang sedang dijual: harga, jendela kuota, model tercakup, cache gratis, dan kuota harian untuk model gratis.

Paket yang sedang dijual, beserta harga dan jendela kuotanya, tercantum sebagai teks di beranda kenari dan sebagai JSON di GET https://kenari.id/api/plans.

Paket

PAYG

Memuat paket...