Moods and billing

Generasi dibayar dengan mood, saldo yang sama dengan yang dipakai dashboard Mager. Satu akun, satu saldo, baik pekerjaannya datang dari produk maupun dari API.

Biaya sebuah task

Setiap response task membawa objek billing:

"billing": {
  "base_moods": 10,
  "charged_moods": 15,
  "extra_moods_charged": 5
}

• base_moods — biaya generasinya sendiri. Ditentukan oleh model dan tier yang Anda minta.
• charged_moods — yang benar-benar Anda bayar: ceil(base_moods × price_multiplier).
• extra_moods_charged — selisihnya, charged_moods − base_moods.

Pengali adalah tarif per akun yang disepakati untuk akses API. Pengali 1.5 pada generasi seharga 10 mood menjadi 15 mood.

Biaya bergantung pada model, model_tier, dan output_count. Meminta empat output kira-kira empat kali lipat biaya satu output.

Memeriksa saldo

curl https://api.mageran.ai/api/v1/balance \
  --header 'x-mager-api-key: YOUR_API_KEY'

{
  "moodsBalance": 250,
  "moodsUsed": 50,
  "moodsGranted": 300,
  "priceMultiplier": 1.5,
  "rateLimit": {
    "perMinute": 60,
    "perDay": 5000,
    "accountPerMinute": 60,
    "accountPerDay": 5000
  }
}

moodsBalance adalah sisa saldo Anda. moodsGranted adalah total seumur hidup yang pernah ditambahkan ke akun.

Endpoint ini butuh scope BALANCE.

Saat saldo habis

Task yang akan membuat saldo Anda minus ditolak, bukan dijalankan sebagian. Periksa saldo sebelum menjalankan batch, atau tangani kegagalannya dan sampaikan ke pengguna — job yang mati di tengah batch tanpa penjelasan adalah versi terburuk dari kasus ini.

Perlakukan GET /balance sebagai health check, bukan panggilan per permintaan. Membacanya sebelum setiap generasi menghabiskan rate limit Anda untuk angka yang berubah lambat.