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.

Paket dan jendela kuota

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

Jendela	Panjang
5 jam	5 jam
Mingguan	7 hari
Bulanan	30 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. Memperpanjang paket yang sama lebih awal hanya memperpanjang siklus dan tidak mengubah jadwal reset. 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.

Model tercakup

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.

Membayar paket

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.

Perpanjangan dan perpanjang otomatis

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.

Mulai siklus baru

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 dari hadiah atau trial, kupon, dan paket yang sudah tidak dijual tidak bisa dimulai ulang, dan dashboard memberi tahu hal itu. 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 kuota habis

Saat salah satu jendela yang punya plafon habis, dua pengaturan akun menentukan yang terjadi berikutnya. Kamu bisa menemukannya di halaman Langganan pada Batas dan fallback, di bagian Saat kuota habis. Keduanya nonaktif secara bawaan.

Lanjut pakai saldo	Alihkan ke model gratis	Yang dilakukan request
Aktif	Nonaktif	Lanjut, ditagih ke saldo. Batas pengeluaran PAYG di Cara penagihan tetap berlaku.
Aktif	Aktif	Lanjut, ditagih ke saldo. Model gratis dipakai hanya saat pilihan saldo dimatikan.
Nonaktif	Aktif	Dialihkan ke model gratis tanpa biaya.
Nonaktif	Nonaktif	Ditolak 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. Saat paket sudah berakhir, request ke model yang dulu ditanggungnya mengikuti dua pengaturan yang sama. Kalau keduanya nonaktif, request mengembalikan plan_limit_reached sampai kamu memperpanjang atau mengaktifkan salah satunya.

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.

Dua pengaturanmu tetap menentukan yang terjadi setelah kuota habis. Kalau Lanjut pakai saldo nonaktif, request berbayar ke endpoint ini mengembalikan HTTP 429 dengan plan_limit_reached, bukan memotong saldo. Alihkan ke model gratis tidak membantu di sini, karena model berbayar pada endpoint ini tidak punya versi gratis. Model yang berharga Rp 0 tetap dilayani. Akun tanpa paket dan tanpa kupon tidak terpengaruh dan membayar dari saldo seperti biasa.

Pencarian web dan pengambilan halaman bekerja berbeda. Setiap paket menyertakan jatah panggilan harian, dihitung per hari UTC. Di atas jatah itu, panggilan ditagih ke saldo hanya kalau Lanjut pakai saldo aktif. 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.

Cache gratis

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.

Kode dan kupon

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, dua pengaturanmu di Saat kuota habis menentukan yang terjadi berikutnya. Cara kerja kode ada di Kode & referral, dan field kupon ada di Kuota akun.

Model khusus pelanggan

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.

Cek kuota dari kode

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.

Lihat juga

Paket

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

PAYG

Memuat paket...