HSSRouter

Overview

Providers

ID	Name	Adapter	Status

Urutan awal: list provider yang sudah ada. Kolom Last Use/Last Status diambil dari provider_attempts terakhir.

Aksi	ID	Name	Adapter	Base URL	Credential	Models	Last Use	Last Status	Probe	Status

Akun & Credential

Satu-satunya tempat memasukkan credential. Pilih provider dulu — tahapan menyesuaikan adapternya: OAuth (Claude/Codex) memakai tautan login, API key cukup satu kolom. Token diuji ke provider lalu disimpan terenkripsi di database. HSSRouter tidak membaca berkas credential CLI mana pun, jadi perilakunya sama di server mana saja. Satu provider boleh punya banyak akun; urutan pemakaian mengikuti priority (kecil = didahulukan).

Aksi	ID	Provider	Label	Preview	Account ID	Diuji	Terakhir dipakai	Priority	Status	Last Error	Rotate JSON

Kolom Diuji menandai credential yang sudah terbukti diterima provider. Terakhir dipakai dihitung dari riwayat permintaan nyata: angka utama = terakhir dicoba, keterangan di bawahnya = terakhir benar-benar berhasil. Keduanya dipisah karena akun dengan token mati tetap dicoba terus-menerus — kalau hanya "dipakai" yang tampil, akun itu terlihat sehat padahal tidak pernah sukses. Tombol Rotate mengganti token tanpa menghapus baris, sehingga priority dan riwayat tetap utuh.

Upstream Models

Aksi	ID	Provider	Upstream	Tools	Enabled

Buat Client

Tambah Saldo

Users

Aksi	ID	User	Role	Status	Akses web	Request API terakhir	Paket	Berlaku s.d.	Limit (% pakai)	Balance	Reserved

Akses web = login terakhir ke web client. Request API terakhir = panggilan API terakhir beserta hasilnya. Keduanya terpisah karena bisa sangat berbeda: user yang rajin memanggil API lewat CLI mungkin tidak pernah membuka web. Angka tolak menghitung request yang ditolak sebelum diproses (saldo habis, key mati, limit, semua route gagal) — tolakan tidak tercatat sebagai request biasa, jadi tanpa kolom ini user yang selalu gagal justru terlihat tidak pernah memakai API.

Buat Public Model

Public Models

Aksi	ID	Slug	Status	Dilayani	Price in/out	Routes

Kolom Status adalah sakelar manual admin. Kolom Dilayani menunjukkan apakah model benar-benar bisa dipanggil klien sekarang — sebuah model bisa berstatus aktif tetapi tidak terlayani karena providernya kehabisan akun atau sedang kena cooldown kuota. Model yang tidak terlayani otomatis disembunyikan dari daftar model klien, dan muncul kembali sendiri begitu providernya pulih (tanpa perlu diaktifkan ulang).

Finance

Revenue

-

Deposits

-

Outstanding

-

Reserved

-

Requests

-

Per Model

Model	Req	In	Out	Revenue

Per Client

User	Req	Spent	Balance

Usage

Dari Sampai Download CSV

Provider lebih besar dari Client tidak selalu berarti rugi. Dua kolom ini memang basis yang berbeda: Client = taksiran atas payload MENTAH pelanggan (dasar tagihan), Provider = yang benar-benar diproses vendor.

Tiga sebab wajar Provider bisa lebih besar: (1) baris n/a — request lama sebelum estimator aktif, tagihannya tidak pernah tercatat sehingga kolom Client kosong; (2) cache write ikut dihitung vendor sebagai input yang diproses; (3) tokenizer vendor berbeda tipis dari taksiran kami. Yang perlu diperiksa adalah rasio agregat di menu Margin — di sanalah baris pra-estimator sudah disaring.

Request	Token → Client (in/out/total)	Token → Provider asal (in/out/total)	Rasio	Ditagih

Per Model (periode ini)

Model	Req	Client In	Client Out	Provider In	Provider Out	Ditagih

Rincian Request

Time	User	Key	Model (request → provider)	Client In	Client Out	Provider In	Provider Out	MicroRp

Rollups

Period	Model	User	Req	Charge

Reservations

ID	User	Amount	Status	Request

Audit Log

Time	Aktivitas	Entity	ID

My Account

My Balance

-

Reserved

-

Active Keys

-

Daftar model & harga API dipindah ke menu Models.

My API Keys

Aksi	ID	Name	Prefix	Status	Dibuat	Budget

Panduan pakai di Hermes
1. Salin API key lengkap saat baru dibuat / diganti; key lama tidak bisa ditampilkan ulang.
2. Tambahkan provider OpenAI-compatible di Hermes:
base_url: https://api.hssproject.com/v1
api_key: hss_...
3. Isi nama model persis seperti di menu Models, contoh: hss/sonnet-5. Awalan hss/ wajib; nama yang tidak terdaftar ditolak 403.
Cadangan tanpa TLS (bila HTTPS bermasalah): http://router.hssproject.com:9090/v1

Panduan pakai di Claude Code CLI
HSSRouter berbicara dialek Anthropic, jadi Claude Code bisa diarahkan ke sini tanpa tool tambahan. Kuncinya tiga variabel: ANTHROPIC_BASE_URL (tanpa /v1 — Claude Code menambahkannya sendiri), ANTHROPIC_AUTH_TOKEN yang diisi API key Anda, dan ANTHROPIC_MODEL yang menentukan model mana yang dipakai.

Ganti hss/sonnet-5 di semua contoh dengan model pilihan Anda — salin namanya dari menu Models. Ketiga variabel ini selalu dipasang bersama; tanpa ANTHROPIC_MODEL, Claude Code memakai nama model bawaannya yang tidak kami kenali.

Linux / macOS — sekali pakai di terminal:

export ANTHROPIC_BASE_URL=https://api.hssproject.com
export ANTHROPIC_AUTH_TOKEN=hss_xxxxxxxx
export ANTHROPIC_MODEL=hss/sonnet-5
claude

Supaya permanen — jalankan sekali, lalu tutup dan buka terminal baru:

cat >> ~/.bashrc <<'EOF'
export ANTHROPIC_BASE_URL=https://api.hssproject.com
export ANTHROPIC_AUTH_TOKEN=hss_xxxxxxxx
export ANTHROPIC_MODEL=hss/sonnet-5
EOF
source ~/.bashrc

Pemakai zsh (bawaan macOS): ganti kedua ~/.bashrc menjadi ~/.zshrc.

Windows PowerShell — sekali pakai:

$env:ANTHROPIC_BASE_URL = "https://api.hssproject.com"
$env:ANTHROPIC_AUTH_TOKEN = "hss_xxxxxxxx"
$env:ANTHROPIC_MODEL = "hss/sonnet-5"
claude

Supaya permanen di Windows (tersimpan di profil pengguna):

setx ANTHROPIC_BASE_URL "https://api.hssproject.com"
setx ANTHROPIC_AUTH_TOKEN "hss_xxxxxxxx"
setx ANTHROPIC_MODEL "hss/sonnet-5"

setx baru berlaku di jendela terminal BARU — tutup dan buka lagi PowerShell sebelum menjalankan claude.

Mengganti model yang sudah permanen. Jalankan setx lagi dengan nama baru (Windows), atau ubah baris export ANTHROPIC_MODEL di ~/.bashrc lalu source ~/.bashrc (Linux/macOS). Untuk mencoba model lain sekali saja tanpa mengubah setelan permanen, pakai flag: claude --model hss/gpt-5-5.

Memeriksa setelan sudah benar:

echo $ANTHROPIC_MODEL          # Linux/macOS
$env:ANTHROPIC_MODEL           # PowerShell

Kalau kosong padahal sudah dipasang permanen, terminalnya belum dibuka ulang.

Memilih model — baca ini dulu. Daftar yang muncul saat Anda mengetik /model di Claude Code (Default, Opus, Sonnet, Haiku, lengkap dengan harga dolar) adalah daftar bawaan aplikasi itu sendiri, bukan model kami. Claude Code tidak pernah menanyakan daftar model ke server, jadi model HSSRouter tidak akan pernah muncul di menu itu — berapa pun model yang Anda miliki. Ini bukan tanda ada yang rusak.

Model kami dipilih lewat variabel ANTHROPIC_MODEL di atas, atau flag --model untuk sekali jalan. Setelah itu baris paling bawah di menu /model akan berubah menjadi nama model Anda, ditandai Custom model. Itulah yang benar-benar dipakai.

Pakai nama model yang persis. Daftar lengkap ada di menu Models — salin apa adanya. Nama yang tidak terdaftar akan ditolak

403
           “model tidak diberikan untuk user ini”

, yang mudah dikira masalah izin padahal sekadar salah nama.

Perhatikan pola penamaannya — awalan hss/, lalu nama pendek tanpa kata “claude”:

hss/sonnet-5      BENAR
hss/claude-sonnet SALAH  (tidak ada model dengan nama ini)
sonnet-5          SALAH  (awalan hss/ wajib)

hss/auto memilihkan model untuk Anda. Praktis, tetapi bila provider yang ditunjuknya sedang bermasalah, hss/auto ikut gagal — sebutkan model secara eksplisit kalau Anda butuh kepastian.

Model bisa hilang dari daftar, lalu kembali sendiri. Model yang providernya sedang kehabisan kuota atau kehilangan akun aktif sengaja kami sembunyikan supaya Anda tidak memilih sesuatu yang pasti gagal. Model itu muncul lagi otomatis begitu providernya pulih — tidak perlu melakukan apa pun. Karena itu isi menu Models bisa berbeda dari hari ke hari.

Uji cepat tanpa membuka sesi interaktif:

claude -p "sebutkan 3 warna" --max-turns 1

Perhatikan bedanya: Hermes memakai alamat dengan /v1, Claude Code tanpa /v1 (ditambahkan sendiri oleh Claude Code). Menukar keduanya menghasilkan 404 yang terbaca seperti masalah login.

Kalau muncul 401, API key salah atau sudah dinonaktifkan. Kalau 402, jatah token Anda habis atau satu permintaan melebihi batas — lihat menu Usage Limits untuk angka pastinya.

Soal harga yang tampil di menu model Claude Code. Saat memilih model, Claude Code menampilkan angka dolar seperti $5/$25 per Mtok. Angka itu berasal dari daftar bawaan di dalam aplikasi Claude Code, bukan dari HSSRouter, dan tidak ada hubungannya dengan tagihan Anda. Tarif yang benar-benar berlaku ada di menu Models pada dashboard ini, dalam rupiah.

Cadangan tanpa TLS: http://router.hssproject.com:9090 (tetap tanpa /v1). Peramban memaksa HTTPS untuk alamat *.hssproject.com, tetapi CLI seperti claude dan Hermes tidak terpengaruh, jadi alamat cadangan ini masih bisa dipakai dari terminal.

Paket Langganan

Paket menentukan harga, masa aktif, dan batas pemakaian. Semua pelanggan pada paket yang sama memakai batas yang sama; yang dihitung terpisah per klien adalah pemakaiannya. Batas token boleh ditulis singkat: 5M = 5 juta, 100K = 100 ribu. Isi 0 bila tidak ingin dibatasi.

Nama paket Deskripsi Harga per bulan (Rp) Masa aktif (hari)

Kuota biaya / minggu (Rp) Rem tiap berapa jam Kuota biaya per rem (Rp)

Kuota dihitung dalam RUPIAH, bukan jumlah token. Alasannya: tarif tiap model berbeda jauh — model termurah Rp 4.071 per 1 juta token, termahal Rp 354.000 (selisih 87×). Kalau kuota dihitung per token, satu pelanggan yang memakai model termahal menghabiskan biaya puluhan kali lipat dari harga paketnya, padahal ia hanya memilih model terbaik yang tersedia.

Limit token (lama — hanya dipakai bila kuota rupiah diisi 0)

Limit token / minggu Limit token per rem

Dibiarkan agar paket lama tetap berjalan apa adanya sampai kuota rupiahnya diisi. Begitu kuota rupiah > 0, angka token di sini diabaikan.

Limit token lama — mingguan: tanpa batas · per rem: tanpa batas

Aksi	ID	Nama	Harga/bln	Masa aktif	Limit mingguan	Rem	Aktif	Pelanggan

Pelanggan Aktif

Pemasangan paket ke pelanggan dilakukan di menu Users (saat menambah user, atau lewat tombol Edit).

Klien	Paket	Berlaku sampai	Terpakai (minggu)	Terpakai (rem)

Kegagalan & Penolakan

Dua sumber kegagalan yang berbeda sifatnya. Ditolak di pintu masuk = permintaan klien yang tidak pernah sampai ke provider (limit, saldo, izin model, API key) — perlu tindakan konfigurasi. Gagal ke provider = permintaan yang sudah diterima tetapi upstream-nya bermasalah — perlu perbaikan kredensial atau failover.

Ditolak di pintu masuk

-

Gagal ke provider

-

Request berakhir error

-

Ditolak di pintu masuk (dari klien)

Sebelumnya penolakan tidak meninggalkan jejak sama sekali: trafik tampak sehat di dashboard sementara klien terus ditolak.

Waktu	User	Model	HTTP	Alasan	Rincian	IP

Gagal ke provider (upstream)

Waktu	User	Provider	Model upstream	Percobaan	Status	HTTP	Latensi	Error

Request yang berakhir error

Sudah melewati semua percobaan provider dan tetap gagal.

Waktu	Request	User	Model	Kode error

Setting Global

Berlaku untuk seluruh sistem dan langsung aktif tanpa restart.

Rekening Pembayaran

Ditampilkan ke pelanggan di layar Upgrade Paket. Kosongkan bila pembayaran diatur di luar sistem — pelanggan akan diminta menghubungi admin.

Rekonsiliasi Perhitungan Token

HSSRouter menghitung token sendiri dari payload mentah klien. Untuk provider yang melaporkan pemakaian token (Claude, Codex, Gemini), hitungan kita dicocokkan ke angka mereka dengan aturan:

hitung = perhitungan sendiri
bila hitung < token_provider              -> hitung = token_provider
bila hitung > token_provider x (100%+N%)  -> hitung = token_provider x (100%+N%)

Artinya angka provider menjadi lantai, dan plafonnya N% di atas angka itu. Provider tanpa metering token (ds2api, QwenGate — keduanya proxy sesi browser) tidak ikut dicocokkan karena angkanya bukan pembanding yang sah.

Percobaan Ulang ke Provider

Saat provider gagal sesaat — koneksi diputus, timeout, HTTP 5xx, atau 429 yang ditandai x-should-retry — router mengulang panggilan itu sendiri sebelum menyerah. Klien resmi seperti Claude Code melakukan hal yang sama; tanpa ini satu sendatan kecil langsung menjadi kegagalan yang dilihat klien.

Kegagalan yang tidak diulang: kredensial ditolak, kuota habis, dan retry-after lebih dari 5 detik — menunggu di situ tidak menolong, lebih baik router pindah provider.

Usage Limits

-

Belum ada data.

Rincian Pemakaian

Riwayat pemakaian yang sudah terjadi — bukan sisa jatah. Jatah paket dihitung dari biaya, bukan jumlah token, jadi angka token di bawah ini tidak bisa dipakai memperkirakan sisa limit.

Mode	Request	Token diproses	Ditagih

Arti mode:
• Ditanggung paket — masih di dalam kuota langganan. Saldo tidak dipotong.
• Kuota paket habis → saldo — Anda punya paket aktif, tapi kuota jendela ini sudah terpakai, jadi kelebihannya diambil dari saldo. Hanya terjadi kalau saklar di atas dinyalakan; kalau dimatikan, permintaan ditolak sampai jendela berikutnya.
• Tanpa paket → saldo — tidak ada langganan aktif, jadi setiap permintaan langsung dibayar dari saldo.
Dua mode terakhir sama-sama memakai saldo dan tarif per token yang sama. Yang membedakan hanya sebabnya, dan itu dipisah supaya Anda bisa melihat berapa banyak pemakaian yang keluar dari jatah paket.

My Usage

Time	Model	Key	In	Out	Charged

Validasi Pembayaran

Pengajuan upgrade paket dari dashboard pelanggan. Periksa bukti transfer sebelum menyetujui — menyetujui langsung mengaktifkan paket dan menggantikan paket lama.

Hanya yang menunggu

Aksi	Tanggal	Pelanggan	Paket	Jumlah	Bukti	Catatan	Status

Upgrade Paket

Pilih paket, lakukan pembayaran, lalu unggah bukti transfer. Admin akan memeriksa dan mengaktifkan paket Anda. Paket lama tetap berjalan sampai pengajuan disetujui.

Riwayat Pengajuan

Tanggal	Paket	Jumlah	Status	Catatan Admin

Models

Tarif di halaman ini yang berlaku untuk tagihan Anda. Semua harga dalam rupiah per 1 juta token.

Aplikasi CLI (mis. Claude Code) menampilkan daftar harga bawaannya sendiri dalam dolar — misalnya $5/$25 per Mtok. Angka itu berasal dari tabel di dalam aplikasi tersebut, bukan dari HSSRouter, dan tidak mencerminkan tarif yang kami kenakan. Abaikan angka dolar di sana; gunakan tabel ini.

Model dengan tarif Rp 0 berarti dipakai lewat kuota paket langganan, bukan per-token.

Klik nama model untuk menyalinnya, lalu pakai apa adanya: claude --model <nama> atau isi ANTHROPIC_MODEL. Panduan lengkap ada di menu My API Keys.

Model	Nama	Input / 1 juta token	Output / 1 juta token

My Wallet

Time	Type	Amount	Note

HSSRouter

Ganti Password

Overview

Overview

Providers

Provider

Tambah Provider

Akun & Credential

Upstream Models

Buat Client

Tambah Saldo

Users

Edit User

Batas Pemakaian

Buat Public Model

Public Models

Edit Public Model

Finance

Per Model

Per Client

Usage

Per Model (periode ini)

Rincian Request

Rollups

Reservations

Audit Log

My Account

My API Keys

Edit API Key

Paket Langganan

Pelanggan Aktif

Kegagalan & Penolakan

Ditolak di pintu masuk (dari klien)

Gagal ke provider (upstream)

Request yang berakhir error

Setting Global

Rekening Pembayaran

Rekonsiliasi Perhitungan Token

Percobaan Ulang ke Provider

Usage Limits

Rincian Pemakaian

My Usage

Validasi Pembayaran

Upgrade Paket

Riwayat Pengajuan

Models

My Wallet

Raw Output