認証 - Hostlinku Docs

Gateway Hostlinku は、sk-… 形式の API キーを用いた Bearer トークン 認証を採用しています。/v1/* エンドポイントへのすべてのリクエストに、API キーを含めてください：

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

エンドポイント Anthropic Messages については、ヘッダー x-api-key: sk-… も受け入れられます。 APIキーは、console.hostlinku.comのAPI Keysメニューで作成・管理します。

APIキーの作成

APIキーはSHA-256ハッシュとしてサーバーに保存されます。元の値は一切保存されず、復元することもできません。レガシー形式（hl_live_…）の古いAPIキーも、認証ではプレフィックスではなくハッシュに基づいて照合されるため、引き続き機能します。

APIキーの作成時のオプションの有効期限：

選択肢	行動
一度も	APIキーは取り消されるまで有効です
30日／90日／365日	その期間が過ぎると、APIキーは自動的に無効になります
カスタム日付	選択した日付に有効期限が切れます

有効期限が切れたAPIキーは、以下の理由で拒否されます：

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

各APIキーには、USD単位の利用制限（creditLimit）を設定でき、リセット期間は以下の通りです：

使用量は、そのAPIキーに対して記録された実際のリクエスト費用（requests.customer_cost）に基づいて計算されます。累積費用が上限に達すると、それ以降のリクエストは402 PAYMENT_REQUIREDとして拒否されます：

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

クレジットの限度額はアカウント残高とは異なります。限度額は1つのAPIキーごとに設定されるのに対し、アカウント残高はすべてのAPIキーの資金源となります。リクエストを実行するには、両方が十分な額である必要があります。課金と残高をご覧ください。

与信限度額に加え、ゲートウェイではAPIキーごとにレート制限が適用されます：

制限を超えると、429 RATE_LIMITED が発生します。詳細は使用状況と制限をご覧ください。

状況	HTTP	`error.code`	メッセージ
ヘッダー「`Authorization`」が存在しないか、Bearer ではない	401	`UNAUTHORIZED`	`Endpoint ini memerlukan API key Hostlinku: kirim header Authorization: Bearer sk-… (atau x-api-key). …`
APIキーが認識されない、入力ミスがある、または無効化されている	401	`UNAUTHORIZED`	`API key tidak valid atau sudah dicabut.`
APIキーの有効期限が切れています	401	`UNAUTHORIZED`	`API key sudah kedaluwarsa.`
APIキーは、`/api/*`コンソールのエンドポイントで使用されます。	403	`API_KEY_NOT_ALLOWED`	`API key hanya berlaku untuk endpoint gateway /v1/* …`
APIキーがクレジット制限に達しました	402	`PAYMENT_REQUIRED`	`Limit kredit API key tercapai (…)`
予約リクエストを行うには、アカウントの残高が不足しています	402	`PAYMENT_REQUIRED`	`Saldo kredit tidak cukup untuk request ini.`
レート制限を超過	429	`RATE_LIMITED`	`Rate limit terlampaui. …`