Jatah bulanan Anda, batas yang melindunginya, apa yang terjadi saat tercapai, dan cara memantau penggunaan.

Satu jatah, reset tiap bulan

Paket tingkat tetap (Pro) memulai tiap siklus tagihan dengan jatah bulanan baru berupa kredit yang bisa dibelanjakan pada biaya provider asli (markup token 0%), mencakup model Budget, Mid, dan Premium — model kelas Ultra memotong saldo prabayar Anda, bukan jatah ini. Jatah reset pada tanggal perpanjangan langganan Anda tiap siklus, bukan tanggal 1 kalender, dan sisa yang tidak terpakai akan hangus — tidak dibawa ke siklus berikutnya. PAYG tidak punya jatah tetap; ia bersifat prabayar pada biaya provider asli (markup 0%) tanpa biaya bulanan.

Reset berbasis siklus. Jatah reset pada tanggal perpanjangan langganan Anda tiap bulan, bukan tanggal 1 kalender — bahkan pada penagihan tahunan, jatah tetap reset bulanan mengikuti siklus tersebut. Jatah yang tidak terpakai tidak dibawa ke bulan berikutnya.

Batas per kelas model

Di atas jatah keseluruhan, setiap pelanggan punya batas token mingguan dan bulanan per kelas model (budget / mid / premium / ultra). Tingkat yang lebih rendah tidak bisa menjangkau kelas Premium atau Ultra, dan bahkan Pro tidak bisa melampaui batas kelasnya. Mencapai batas mengembalikan 402 token_quota_exceeded dengan kelas dan jendela yang terlampaui.

respons 402

HTTP/1.1 402 Payment Required
content-type: application/json

{
  "detail": {
    "error": "token_quota_exceeded",
    "model_tier_class": "premium",
    "window": "monthly"
  }
}

Field model_tier_class memberi tahu kelas model mana yang mencapai batas; window bernilai weekly atau monthly. Pindah ke kelas model lebih murah atau naikkan batas dengan token pack.

Apa yang terjadi saat jatah habis

Saat jatah paket tingkat tetap habis, hasilnya bergantung pada tombol overage per akun:

Overage aktif: penggunaan lanjutan memotong saldo prabayar Anda alih-alih diblokir.
Overage nonaktif: permintaan diblokir dengan 402 hingga reset berikutnya atau top-up.
PAYG tidak pernah diblokir oleh kuota — tidak punya jatah tetap dan selalu prabayar pada biaya provider asli (markup 0%).

RPM / TPM terpisah dari kuota

Batas laju bukan hal yang sama dengan kuota token Anda. RPM (permintaan/menit) dan TPM (token/menit) adalah penjaga lonjakan anti-banjir yang mengembalikan 429 rate_limit_exceeded — pembatasan sementara, bukan batas pengeluaran. Kuota token bulanan Anda justru mengembalikan 402 token_quota_exceeded. Burst credit (token pack) bisa menaikkan sementara batas token suatu kelas dari saldo prabayar.

Lihat Rate Limits untuk angka RPM/TPM/inflight per tingkatan, header respons, dan pola backoff.

Pantau token berbobot langsung

Halaman Usage di dashboard menampilkan token berbobot terpakai vs. jatah dan tanggal reset. Secara programatik, panggil endpoint kuota langganan dengan kunci API Anda.

curl

curl https://api.anoman.io/anoman/v1/subscription/quota \
  -H "Authorization: Bearer anm-sk-..."

Enterprise dan PAYG mengembalikan limit 0, artinya tanpa batas bulanan tetap.

Pantau kuota Anda

Halaman Usage menunjukkan persis berapa token berbobot tersisa dan kapan reset.

Kuota & overage