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	Paket	Berlaku s.d.	Limit (% pakai)	Balance	Reserved

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

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

Per Model (periode ini)

Model	Req	Client In	Client Out	Provider In	Provider Out	Ditagih

Rincian Request

Time	User	Key	Model	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. Gunakan model yang diberikan admin, contoh: hss/auto.
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 dua variabel: ANTHROPIC_BASE_URL (tanpa /v1 — Claude Code menambahkannya sendiri) dan ANTHROPIC_AUTH_TOKEN yang diisi API key Anda.

Linux / macOS — sekali pakai di terminal:

export ANTHROPIC_BASE_URL=https://api.hssproject.com
export ANTHROPIC_AUTH_TOKEN=hss_xxxxxxxx
claude

Supaya permanen, tambahkan dua baris export di atas ke ~/.bashrc (atau ~/.zshrc), lalu source ~/.bashrc.

Windows PowerShell — sekali pakai:

$env:ANTHROPIC_BASE_URL = "https://api.hssproject.com"
$env:ANTHROPIC_AUTH_TOKEN = "hss_xxxxxxxx"
claude

Supaya permanen di Windows (tersimpan di profil pengguna):

setx ANTHROPIC_BASE_URL "https://api.hssproject.com"
setx ANTHROPIC_AUTH_TOKEN "hss_xxxxxxxx"

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

Memilih model. Nama model bawaan Claude Code dipetakan otomatis oleh server. Untuk memaksa satu model tertentu:

export ANTHROPIC_MODEL=hss/auto        # Linux/macOS
$env:ANTHROPIC_MODEL = "hss/auto"      # PowerShell

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.

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.

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.

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

Mode	Request	Token	Ditagih

My Usage

Time	Model	Key	In	Out	Charged

Models

Model yang tersedia untuk akun Anda beserta harga API (per 1 juta token). Model dengan tarif Rp 0 berarti dipakai lewat kuota paket langganan, bukan per-token.

Model	Nama	Input / 1M token	Output / 1M 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

Rekonsiliasi Perhitungan Token

Percobaan Ulang ke Provider

Usage Limits

Rincian Pemakaian

My Usage

Models

My Wallet

Raw Output