Billing & Saldo

Cara kerja saldo kredit Hostlinku, metode top-up, dan dasar perhitungan biaya per token

Billing Hostlinku berbasis saldo kredit (prepaid) dalam USD. Setiap request chat completion dipotong dari saldo sesuai token yang benar-benar terpakai; tidak ada langganan bulanan wajib dan tidak ada biaya tersembunyi.

Saldo akun

Saldo dikelola sebagai satu akun kredit per pengguna dengan field berikut:

Nilai ini terlihat di console → menu Credits/Saldo, dan tersedia lewat API sesi GET /api/wallet/account (dipakai console). Untuk aplikasi Anda, patokan real-time tetap hostlinku.cost pada setiap respons dan riwayat di log.

Top-up saldo

1. Masuk ke console.hostlinku.com → Isi Saldo.
2. Pilih nominal (preset yang tersedia berasal dari kebijakan top-up backend; ada batas min/max).
3. Pilih metode pembayaran:

4. Selesaikan pembayaran. Kredit masuk otomatis setelah webhook provider tervalidasi — tidak perlu konfirmasi manual.

Dari sisi API, prosesnya:

POST https://api.hostlinku.com/api/wallet/topup
Content-Type: application/json
Cookie: hl_session=…   # sesi console

{
  "amount": 10,
  "provider": "stripe"
}

Respons berisi URL checkout/sesi pembayaran dari provider. Validasi server menolak nominal di luar kebijakan top-up (min/max diatur admin, maksimum teknis $10.000 per transaksi) dengan 400 BAD_REQUEST, dan menolak provider yang belum dikonfigurasi dengan 402 PAYMENT_REQUIRED.

Dasar perhitungan biaya

Biaya setiap request dihitung per token dengan harga customer model yang dipakai:

biaya = (jumlah_token_input   × harga_input_per_token)
      + (jumlah_token_output  × harga_output_per_token)
      + (token cache read     × harga_cache_read)   ← bila model mendukung caching
      + (token cache write    × harga_cache_write)  ← bila model mendukung caching

• Harga per model (input/output, termasuk harga cache bila ada) tercantum di katalog — lihat Model dan menu Model di console. Angka di respons GET /v1/models adalah harga per 1 token, bukan per 1.000 token.
• Token dihitung dari usage yang dilaporkan provider; bila provider tidak melaporkan usage, gateway memakai estimasi konservatif dan itulah yang ditagihkan (jarang terjadi).
• Untuk streaming, biaya dihitung setelah stream selesai; nilai pada blok hostlinku.cost tetap akurat.
• Perhitungan dilakukan dalam satuan mikro-USD untuk menghindari galat pembulatan floating point, lalu diformat sebagai desimal 8 angka.

402 PAYMENT_REQUIRED — kapan muncul?

Kode 402 selalu berarti butuh kredit, tetapi pesannya membedakan sumbernya:

Riwayat transaksi

Semua pergerakan saldo tercatat di ledger dan bisa dilihat di console → Transaksi (top-up, pemakaian, refund) dengan status, nominal, metode, dan referensi. Lewat API sesi: GET /api/wallet/transactions (mendukung paginasi keyset dan detail per transaksi).