anoman
Konsep

Kuota & overage

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

Jatah bulanan

Satu jatah, reset tiap bulan

Paket tingkat tetap (Starter, Pro) mendapat jatah token berbobot bulanan. Jatah reset per bulan kalender — pada tanggal 1, hitungan terpakai Anda kembali nol tanpa memandang kapan Anda berlangganan. PAYG tidak punya jatah tetap; ia membayar biaya asli penyedia ditambah markup volume kecil 0–5%.

Reset per bulan kalender. Jendela jatah adalah bulan kalender, terpisah dari tanggal penagihan — bahkan pada penagihan tahunan, kuota tetap reset bulanan.

Batas per kelas

Batas per kelas model

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

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.

Overage vs. blokir

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 menagih biaya asli + markup volume 0–5%.

Penjaga lonjakan

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.

Periksa penggunaan

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 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.

Buka UsagePaket & penagihan