anoman
Panduan

Burst credits

Alokasi bulanan untuk sebuah model tier class habis? Beli paket token burst untuk melanjutkan — tanpa meng-upgrade seluruh paket Anda.

Apa itu

Paket token, bukan pengali rate

Berubah di v9.8: Burst credits bukan lagi pengali RPM/RPD. Kini berupa paket token yang menaikkan batas weighted-token Anda untuk sebuah model tier class. RPM/TPM adalah penjaga anti-banjir terpisah.

Saat Anda menghabiskan alokasi weighted-token bulanan untuk sebuah model tier class (budget / mid / premium / ultra), beli paket token burst untuk sementara menaikkan batas kelas tersebut — sehingga Anda bisa melanjutkan tanpa meng-upgrade paket. Paket bersifat Redis-ephemeral dan dipotong dari saldo prabayar Anda.

Untuk penjaga banjir (RPM/TPM/inflight) lihat Rate limits; untuk cara kerja alokasi token itu sendiri lihat Kuota & overage. Hanya tier flat (Starter/Pro) yang butuh burst — Enterprise dan PAYG tidak punya kuota tetap.

Aktifkan

Beli paket burst

Panggil POST /anoman/v1/burst/activate dengan model_tier_class yang ingin ditambah, pack_tokens (berapa banyak tambahan), dan duration_hours. Ini menaikkan batas mingguan/bulanan kelas tersebut selama durasi dan mengembalikan biaya + sisa saldo.

# Buy a burst token pack for a model tier class. Additively raises your
# weekly/monthly cap for that class for the duration. Deducted from prepaid balance.
curl https://api.anoman.io/anoman/v1/burst/activate \
  -H "Authorization: Bearer anm-sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model_tier_class": "premium",
    "pack_tokens": 5000000,
    "duration_hours": 24
  }'

# → 200
# {
#   "active": true,
#   "model_tier_class": "premium",
#   "weekly_bump": 5000000,
#   "monthly_bump": 5000000,
#   "cost_usd": 90.0,
#   "balance_after": "410.00",
#   "duration_hours": 24,
#   "seconds_remaining": 86400
# }

Kelola

Status, pricing, batal

Cek burst aktif dengan /burst/status, lihat paket yang bisa dibeli tier Anda dengan /burst/pricing, dan batalkan lebih awal dengan /burst/deactivate (tanpa pengembalian dana untuk porsi yang belum terpakai).

# Current active burst for the key
curl https://api.anoman.io/anoman/v1/burst/status \
  -H "Authorization: Bearer anm-sk-..."

# Packs available for your tier (which classes, sizes, prices)
curl https://api.anoman.io/anoman/v1/burst/pricing \
  -H "Authorization: Bearer anm-sk-..."

# Cancel an active burst (no refund on the unused portion)
curl -X DELETE https://api.anoman.io/anoman/v1/burst/deactivate \
  -H "Authorization: Bearer anm-sk-..."

Akses kelas

Paket harus untuk kelas yang bisa Anda akses

Paket burst hanya menambah kapasitas pada model tier class yang sudah bisa diakses paket Anda. Membeli kelas yang tidak bisa Anda jangkau mengembalikan 400 class_not_accessible.

HTTP/1.1 400 Bad Request
content-type: application/json

{
  "error": {
    "type": "invalid_request_error",
    "code": "class_not_accessible",
    "message": "Your plan cannot access the 'ultra' model tier class."
  }
}
# A burst pack only adds headroom to a class your plan already reaches.
# Reach a new class by upgrading your plan, not by buying a burst.

Untuk menjangkau model tier class baru, upgrade paket Anda — paket burst menaikkan batas kelas yang sudah Anda miliki, bukan membuka kelas baru.

Aktifkan burst

Beli dan kelola paket token burst dari halaman Rate Limits di dashboard Anda.

Buka Rate LimitsKembali ke docs