Autentikasi

Gateway Hostlinku memakai autentikasi Bearer token dengan API key berformat sk-…. Sertakan API key pada setiap request ke endpoint /v1/*:

Authorization: Bearer sk-isi-api-key-kamu
Content-Type: application/json

Untuk endpoint Anthropic Messages header x-api-key: sk-… juga diterima. API key dibuat dan dikelola di console.hostlinku.com, menu API Keys.

Membuat API key

Buka console → API Keys → Buat API key.
Isi Nama, opsional Kedaluwarsa, dan opsional Limit kredit.
Salin secret yang ditampilkan. Secret hanya muncul sekali.

API key disimpan di server sebagai hash SHA-256: nilai aslinya tidak pernah tersimpan dan tidak bisa ditampilkan ulang. API key lama dengan format legacy (hl_live_…) tetap berfungsi karena autentikasi mencari berdasarkan hash, bukan prefix.

Masa berlaku API key

Kedaluwarsa opsional saat pembuatan API key:

Pilihan	Perilaku
Tidak pernah	API key berlaku sampai di-revoke
30 / 90 / 365 hari	API key berhenti berlaku otomatis setelah masa itu
Tanggal kustom	Kedaluwarsa pada tanggal yang dipilih

API key yang sudah lewat masa berlaku ditolak dengan:

{
  "status": "error",
  "error": { "code": "UNAUTHORIZED", "message": "API key sudah kedaluwarsa." }
}

Limit kredit per API key

Setiap API key bisa diberi batas pemakaian dalam USD (creditLimit) dengan jendela reset:

Reset	Jendela perhitungan (kalender UTC)
Harian (`daily`)	Sejak 00:00 UTC hari berjalan
Mingguan (`weekly`)	Sejak Senin 00:00 UTC minggu berjalan
Bulanan (`monthly`)	Sejak tanggal 1, 00:00 UTC bulan berjalan
Tanpa reset	Total selama masa aktif API key

Pemakaian dihitung dari biaya request nyata (requests.customer_cost) yang tercatat untuk API key tersebut. Saat akumulasi biaya menyentuh limit, request berikutnya ditolak dengan 402 PAYMENT_REQUIRED:

{
  "status": "error",
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Limit kredit API key tercapai (🪙10.0000 dari 🪙10 total)."
  }
}

Limit kredit berbeda dari saldo akun: limit membatasi satu API key, sedangkan saldo akun adalah sumber dana semua API key. Keduanya harus cukup agar request berjalan. Lihat Billing & Saldo.

Rate limit

Selain limit kredit, gateway menerapkan rate limit per API key:

POST /v1/chat/completions: 600 request per menit per API key.
Endpoint konsol/publik (sesi cookie): 120 request per menit per alamat IP.
Endpoint autentikasi (login, daftar, reset): 30 percobaan per 15 menit per IP.

Melebihi batas menghasilkan 429 RATE_LIMITED. Detailnya di Pemakaian & Limit.

Error autentikasi umum

Situasi	HTTP	`error.code`	Pesan
Header `Authorization` tidak ada atau bukan Bearer	401	`UNAUTHORIZED`	`Endpoint ini memerlukan API key Hostlinku: kirim header Authorization: Bearer sk-… (atau x-api-key). …`
API key tidak dikenal, salah ketik, atau sudah di-revoke	401	`UNAUTHORIZED`	`API key tidak valid atau sudah dicabut.`
API key sudah lewat masa berlaku	401	`UNAUTHORIZED`	`API key sudah kedaluwarsa.`
API key dipakai ke endpoint Console `/api/*`	403	`API_KEY_NOT_ALLOWED`	`API key hanya berlaku untuk endpoint gateway /v1/* …`
API key menabrak limit kreditnya	402	`PAYMENT_REQUIRED`	`Limit kredit API key tercapai (…)`
Saldo akun tidak cukup untuk reservasi request	402	`PAYMENT_REQUIRED`	`Saldo kredit tidak cukup untuk request ini.`
Melampaui rate limit	429	`RATE_LIMITED`	`Rate limit terlampaui. …`

Mulai

Akun

Bantuan

Membuat API key

Masa berlaku API key

Limit kredit per API key

Rate limit

Error autentikasi umum

​Membuat API key

​Masa berlaku API key

​Limit kredit per API key

​Rate limit

​Error autentikasi umum

Membuat API key

Masa berlaku API key

Limit kredit per API key

Rate limit

Error autentikasi umum