認證
使用 Bearer API Key 存取 /v1/*
Hakila Gateway 的公開 API（/v1/*）使用 API Key 認證，不是 OAuth access token。
Authorization 標頭
Authorization: Bearer sk-hakila-...缺少、格式錯誤、停用或過期的金鑰會回傳 401。
管理 API Key
在 Admin 後台「API Keys」頁針對 Workspace 建立金鑰，可設定：
| 欄位 | 說明 |
|---|---|
| Name | 顯示名稱 |
| BudgetTwd | 用量預算（新台幣）；後台以 NTD 進出，存檔時依當下美元匯率換成 USD 上限並固定，Gateway 以 USD 累計。用盡回傳 402 |
| ExpiresAt | 到期時間（UTC）；到期回傳 401 |
| 模型允許清單 | 預設跟隨組織；可改為自訂子集。未允許的模型呼叫會回 400 |
金鑰明文只在建立當下顯示；伺服器只保存 SHA-256 hash。詳見 API Key 概念。
範例
curl https://api.hakila.ai/v1/models \
-H "Authorization: Bearer $HAKILA_API_KEY"與 Admin 登入的差異
| 用途 | 認證方式 |
|---|---|
Gateway /v1/* | Bearer API Key |
Admin /api/admin/* | OpenIddict / OIDC（給後台 UI） |
公開文件只涵蓋 Gateway API。