Hakila Docs

Workspace

Organization、Workspace 與 Gateway 資源的關係

Hakila 以 OrganizationWorkspace 組織資源。Gateway API Key、用量與 BYOK 金鑰通常掛在 Workspace 底下。

階層(概念)

Organization
├── Units(組織單位樹,可選)
├── People(目錄人員,可掛 Unit;≠ 登入帳號)
└── Workspace
    ├── Members(Admin / Member)
    ├── API Keys(可選綁定 Person)
    ├── Provider Keys(BYOK)
    └── Request Logs(用量)

單位/人員可設層級預算;API Key 預算不得超過所屬組織(或人員/單位)允許的上限。

對 API 呼叫的意義

  • 你持有的 API Key 已綁定特定 Workspace 與 Organization
  • 若建立時指定 PersonId,用量可歸在該人員/單位脈絡
  • 請求的用量與花費會記在該 Key / Workspace 脈絡
  • BYOK 可依 Workspace 覆寫上游金鑰

Admin vs Gateway

介面用途
Admin UI / api/admin/*管理組織、單位、人員、成員、金鑰、預算與統計
Gateway /api/v1/*應用程式實際呼叫模型

本文件站聚焦 Gateway;Admin 操作細節之後可另開產品手冊。

本頁目錄