Changelog

依日期倒序記錄公開 API 與文件站的重要變更。局部內容更新不一定發版；有行為變更或新端點時請在此補一筆。

維護慣例

改 MDX 或 openapi/hakila-v1.yaml 後直接 commit / push
Cloudflare Pages 會自動 build 並更新 docs.hakila.ai
新增端點：先更新 OpenAPI → Reference 自動出現 → 必要時補 guide → 在此記一筆

2026-10-30

系統管理「組織管理」新增可用模型分頁，分成 Claude（Claude Code／Claude Desktop）、ChatGPT（Codex）與 Hakila Cloud 三份清單。Claude 與 ChatGPT 和 Console 的第三方工具模型清單是同一份設定
Hakila Cloud 可依組織設定可選模型：預設仍使用平台預設（Claude Auto）；改為自訂後，成員可在聊天輸入框切換組織開放的模型，新對話使用管理員指定的預設模型。每個對話記住自己選的模型

2026-10-24

Hakila Cloud 新增自動記憶：在對話中說「記住…」「忘掉…」會直接新增或刪除記憶；其餘內容在對話閒置 10 分鐘後，由 Claude Haiku 只從使用者自己的訊息中整理出偏好與事實。身分證、信用卡、手機號碼、金鑰、密碼等敏感資料不會被記下
記憶屬於使用者 × API Key 所屬組織，每人每個組織最多 200 條；滿額時只淘汰自動整理的記憶，使用者明確要求記住的不會被自動移除。自動整理的內容與明確要求的記憶衝突時，不會直接覆蓋，而是列為「待確認」由使用者決定
Cloud「記憶與個人化」分頁新增記憶清單：可編輯、刪除、全部清除，確認待確認的記憶，並連回記憶的來源對話；回覆下方會標示「已參考記憶與個人化設定」，模型新增或刪除記憶時會顯示提示
刪除 Cloud 對話時，可選擇一併刪除從該對話學到的記憶；刪除帳號時，記憶、個人化設定與對話摘要一併刪除
Console「系統設定 → 記憶與個人化」新增「自動記憶」開放範圍（關閉／測試帳號／全面開放），並可設定每位使用者每日整理次數上限（預設 500）與整理用模型

2026-10-14

「完整紀錄 Prompt / Response」改為 Enterprise 方案功能，預設關閉；Business 組織無法開啟（403，code: plan_feature_unavailable），原本已開啟的 Business 組織一律改為關閉，Gateway 不再寫入請求與回應內容（用量與費用照常記錄）
Console 新增「組織管理 → 方案設定」：所有方案都看得到目前方案與各方案功能比較，組織管理員可直接送出升級申請（降級或改為其他方案由平台人員處理）。升級僅開放公司行號、政府機關或組織，須填寫單位名稱、聯絡人、手機與公司電話（統一編號選填），負責人員電話確認後開通
新增操作紀錄：Console 與 SCIM 的所有寫入操作，以及登入、註冊、登出（含失敗原因）都會記錄操作者、時間、來源 IP 與請求內容（敏感欄位已遮蔽）；Enterprise 方案的組織可在「組織管理 → 操作紀錄」查詢
新增組織方案：Business（註冊後預設）與 Enterprise。Business 不含組織人員管理（含 SCIM）、模型允許清單、供應商限制、第三方工具模型清單，這些功能需 Enterprise 方案；方案未開放的功能，Console 選單會隱藏，對應的設定 API 回 403（code: plan_feature_unavailable），SCIM 端點回 401。已在使用上述功能的既有組織自動歸為 Enterprise
新增 SCIM 2.0 自動佈建（/scim/v2/Users、/scim/v2/Groups）：Microsoft Entra ID、Okta 等身分提供者可自動同步組織人員（User）與單位（Group）。Token 由組織管理員在 Console 產生；userName 與既有人員 Email 相同時直接接手該人員，保留預算與 API Key 綁定
人員停用後，指派給該人員的 API Key 一律回 401（Console 手動停用或 SCIM active = false 皆同）
Console 新增「組織人員管理」，分為成員管理、組織階層管理、角色管理三個分頁；原「基本資料」頁的組織樹與成員清單移到這裡。人員可設定 Email、啟用狀態，並可直接改所屬單位
組織角色（管理員／一般使用者）與工作區角色分開：只有組織建立者或組織角色為管理員的成員能管理組織，工作區 Admin 不再自動取得組織管理權限。既有的組織建立者與工作區 Admin 已自動設為組織管理員
Console「基本資料」頁移除組織層級的每日生圖張數上限設定（請改用組織預算；API Key 的每日生圖上限不受影響）
模型 id 統一為 開發商/模型名稱，與實際提供服務的供應商無關；同一個 id 走哪家供應商，請求的 model 都一樣
不帶前綴的模型名稱改為在平台目錄找同名模型：剛好一個時補上開發商前綴（例如 gemini-4-argon 對到 google/gemini-4-argon）；有多個同名模型時回 400 並列出候選；找不到時回 404。不再依命名慣例猜開發商，model 為 auto 一律回 400（請寫 hakila/auto 或 openrouter/auto）。所有端點都適用
不在目錄中的模型 id 改回 404（原為 400）；舊的模型 id 不會自動轉換
多供應商與備援：選路順序為平台設定的優先順序 → 請求的 provider → 組織的供應商限制 → 略過接不下請求或沒有金鑰的供應商 → 工作區 BYOK 優先。同一個模型經同一家供應商短時間內連續失敗時自動暫停（30 秒起、最長 5 分鐘）
所有端點的回應新增 x-hakila-provider header，標示實際提供服務的供應商；非串流 Chat Completions 回應另有 provider 欄位
新增 GET /v1/models/{vendor}/{name}/endpoints（OpenRouter 相容），列出模型可用的供應商、上下文長度、單價與是否暫停
provider 偏好提到不存在的供應商，或 only 列了該模型沒有的供應商時回 400；也接受 OpenRouter 的供應商代號寫法（amazon-bedrock、xai、google-ai-studio 等）
新增組織的供應商限制（Console → 組織 → 供應商限制）：可只允許或排除特定供應商；模型的供應商全被排除時回 403
Console 新增「供應商管理」：平台管理員可新增供應商（含 OpenAI 相容的地端服務）、設定 Base URL 與全域金鑰、查看與重設自動暫停；模型頁改為列出每家供應商的上游名稱、上下文與單價。工作區 BYOK 的供應商清單改為依平台已啟用的供應商自動產生。原本的 local/*、custom/* 自訂端點改由供應商設定；不需要金鑰的地端服務請填任意字串
移除 Console 的「模型更新」頁、模型掃描與 OpenRouter 價格自動同步；模型與單價改由平台管理員在模型頁維護
新增 google/gemini-4-argon（Gemini 4 Argon，推出優惠價 $2 / $10 到 2026-11-30）
Groq 改為供應商，不再用 groq/ 前綴的模型 id：openai/gpt-oss-120b、openai/gpt-oss-20b、openai/gpt-oss-safeguard-20b 由 Amazon Bedrock 與 Groq 提供（Bedrock 優先、Groq 備援，可用 "provider": "groq" 指定）；Qwen 3.8 27B 改為 qwen/qwen3.8-27b，組織允許清單預設開放。舊的 groq/openai/gpt-oss-* 與 groq/qwen/qwen3.8-27b 已下架，請改用新 id
Hakila Models 目錄的「原廠」欄顯示模型開發商，名稱下方列出實際提供服務的廠商
Console「第三方工具模型清單」改為以分頁切換 Codex 與 Claude Code／Claude Desktop。GET /v1/clients/codex/models 只列 ChatGPT（OpenAI GPT）模型與 hakila/auto，不再包含 Claude、Gemini、Grok 與 gpt-oss（見 Codex）；GET /v1/clients/claude-desktop/models、GET /v1/clients/claude-code/models 在 Claude 模型之後加上 hakila/auto
hakila/auto 認出請求來自 Claude Code／Claude Desktop 時只挑 Claude 模型，來自 Codex 時只挑 ChatGPT 模型；也可用 X-Hakila-Client header 明確指定（見第三方工具只挑自家模型）
平台管理員可在 Console「模型列表」拖曳調整模型順序；第三方工具模型清單、Claude Code／Claude Desktop 與 Codex 的模型選單改依這個順序排列（Claude 工具的第一個模型為預設模型），不再固定 Sonnet、Opus 優先或沿用 Codex 範本的順序

2026-10-13

新增 Amazon Bedrock 供應商：Claude、GPT、Grok、Amazon Nova、Llama、Mistral、DeepSeek、Qwen、Kimi、GLM、MiniMax、Gemma、Nemotron、Writer Palmyra 可用於 Chat Completions、Responses 與 Messages（含串流與工具呼叫）；Amazon Titan、Cohere Embed 可用於 POST /v1/embeddings。模型 id 依原開發商命名（例如 meta/llama-4-maverick、anthropic/claude-opus-5-5），見模型與路由
多供應商與備援：同一個模型 id 可由多家供應商提供（例如 anthropic/claude-opus-5 由 Anthropic 與 Amazon Bedrock 提供），遇到 429／5xx、該供應商回 401～404 或連線失敗時自動改送下一家；費用依實際提供服務的供應商單價計算。Chat Completions、Responses 與 Messages 接受 OpenRouter 相容的 provider 欄位（order、only、ignore、allow_fallbacks）指定供應商
Hakila Models 模型頁新增「供應商」表，列出各供應商的文本視窗、最大輸出與單價
OpenAPI info.version → 1.11.0（新增 ProviderPreferences）

2026-10-11

Console「第三方工具模型清單」改為組織層設定，套用到該組織底下所有 API Key。GET /v1/clients/codex/models、GET /v1/clients/claude-desktop/models、GET /v1/clients/claude-code/models 仍先依這把 Key 的允許清單過濾，再套用所屬組織的這份清單

2026-10-09

其他 Coding Agent 指南：OpenCode、Aider、OpenHands、Roo Code、Cline、Goose、Open Interpreter 透過 OpenAI 相容端點接上 Hakila；Gemini CLI 只支援 Gemini 原生協定，目前無法使用
AI 助理與聊天介面指南：OpenClaw、Hermes Agent、PicoClaw、NanoClaw、Letta、Open WebUI、AnythingLLM、Khoj、Jan、Msty、Cherry Studio、LobeChat、Perplexica 的設定方式

2026-10-08

計費變更：服務點數改為 1 點 = 1 美元的模型用量，扣點直接依模型的美元單價計算（usage.cost_points 與 usage.cost 數值相同）。購買以整數點為單位，最低 5 點，以新台幣結帳，含 10% 平台服務費與 5% 營業稅，金額於付款當下計算並記載於該筆訂單。既有組織餘額與餘額警示門檻依舊制換算（× 10/33），帳本另記一筆換算分錄，歷史扣點紀錄不變
用量與預算：以台幣設定的預算改在存檔時依當下美元匯率換成點數上限並固定，不再使用 1 USD = 33 TWD 的固定匯率；既有預算沿用 33 換算
BYOK：命中工作區自帶金鑰的成功請求不再扣服務點數（上游費用由該金鑰的供應商帳戶支付），組織儲值餘額用盡時仍可呼叫。Logs 仍記錄 token。同一把 Hakila API Key 打到尚未綁定 BYOK 的供應商，仍照平台用量扣點，餘額用盡回 402
Messages API：Claude 的 web_search 伺服器端工具開始計費，每次搜尋 US$0.01（與 Anthropic 定價相同），加在該次請求的費用上；web_fetch 與 code_execution 仍只收 token
Claude Desktop 指南：以第三方推論模式（Gateway）讓 Claude Desktop 的 Chat、Cowork、Code 全部改走 Hakila
Console 刪除 API Key 改為軟刪除：金鑰立即失效，但 Request Log 仍保留當初的金鑰名稱並標示「已刪除」
新增 GET /v1/clients/codex/models 與 GET /v1/clients/claude-desktop/models：依 API Key 的允許清單產生 Codex 的 hakila-models.json 與 Claude Desktop 的模型清單（帶 ETag，額度用完仍可呼叫）；Hakila Switcher 啟動時會用它自動更新本機設定
Chat Completions 接受 Responses 格式的扁平工具（{"type":"custom","name",…}，例如 Cursor 自訂 base URL 時送的 ApplyPatch），轉發前改成巢狀格式；帶工具呼叫 GPT-5 之後的 OpenAI 推理模型時改走 OpenAI 原生 Responses API，工具與 reasoning_effort 可以同時使用，custom 工具呼叫以 Chat 格式回傳
OpenAPI info.version → 1.10.0

2026-10-06

新增圖片生成：POST /v1/images（OpenRouter Image API 格式）與 OpenAI 相容的 POST /v1/images/generations、POST /v1/images/edits（multipart 或 JSON）共用同一條管線，可呼叫 GPT Image 2.5、Nano Banana 2／Pro、FLUX.3、Seedream 5.0、Recraft V4.1（OpenRouter 轉接）；xAI Grok Imagine 已在目錄但預設停用
生圖參數依模型能力處理：做不到的回 400，長寬比調到最接近的值，沒有對應旋鈕的參數忽略，所有調整列在 X-Hakila-Adjusted-Params；支援 stream: true（keepalive + 完成事件）與 response_format: "url"（1 小時簽名網址）
生圖計費全有全無；送出前以每張最高價預估，超過任一層預算回 402；Console 可替 API Key 與組織設定每日張數上限（超過回 429、image_quota_exceeded，台北時間 00:00 重置）；工作區可開啟原圖保留（1～90 天），在 Log 明細查看縮圖
新增 GET /v1/images/models 與 GET /v1/images/models/{author}/{slug}/endpoints（能力描述與計價，格式同 OpenRouter）；GET /v1/models 支援 output_modalities 篩選，模型 type 新增 image
Hakila Models 新增 Image 分類，可直接試打生圖模型
OpenAPI info.version → 1.9.0
Responses API 支援所有 chat 模型：Claude、Gemini、Grok、OpenRouter 與自訂端點由 Hakila 轉換協定，回應與 SSE 事件轉回 Responses 格式（含完整事件序列與 usage）。轉換模式為無狀態：previous_response_id 與 background 回 400、store 忽略；function／custom／namespace 工具會轉換，web_search 等 OpenAI 內建工具移除並列在 X-Hakila-Dropped-Tools header
Responses 轉換模式的推理：reasoning.effort 換成各家設定（Claude adaptive thinking／effort 或 thinking 預算、Gemini 與 Grok 的 reasoning_effort）；Claude 思考摘要以 reasoning_summary_text 事件送出，Claude 簽章與 Gemini thought signature 加密放在 reasoning item 的 encrypted_content，下一輪原樣帶回即可延續推理
hakila/auto 在 Responses API 的候選不再限於 OpenAI；帶 previous_response_id 或 background 時仍只挑 OpenAI。Responses 的裸模型名稱 claude-* 會正規成 anthropic/claude-*
Chat Completions 呼叫 Claude 時，回應（含串流）多了 reasoning_details（思考文字與簽章，OpenRouter 格式），送回 assistant 訊息的 reasoning_details 會還原成 thinking block；帶 reasoning_effort 且沒有自訂 thinking 時，會換成 Claude 的思考設定
新增 Messages API：POST /v1/messages 與 POST /v1/messages/count_tokens 對齊 Anthropic 規格，給 Claude Code、Anthropic SDK 使用；裸名稱 claude-* 自動補 anthropic/，認證可用 x-api-key 或 Bearer，錯誤為 Anthropic 形狀；支援 Response Cache，不支援 Preset
Messages API 支援所有 chat 模型：Claude 原樣透傳，GPT、Gemini、Grok、OpenRouter 與自訂端點由 Hakila 轉換協定，回應與 SSE 事件轉回 Messages 格式（無狀態）。thinking／output_config.effort 換成各家推理等級，推理摘要以 thinking block 送出，OpenAI 加密推理與 Gemini thought signature 加密放在 thinking 的 signature 或 redacted_thinking 的 data；切回 Claude 時會先移除其他模型的推理 block。超過 64 字元的工具名稱（例如 MCP 工具）會自動縮短並在回應還原；web_search_20250305 等 Anthropic 伺服器端工具移除並列在 X-Hakila-Dropped-Tools。hakila/auto 的候選不再限於 Anthropic；非 Claude 模型的 count_tokens 回傳本機粗估值
Messages 與 Responses 的轉換模式打 GPT-5 之後的 OpenAI 推理模型時，改走 OpenAI 原生 Responses API（store: false），工具與推理可以同時使用
新增 Codex 指南；Hakila 的 Codex 模型清單加入 Claude Opus 5、Claude Sonnet 5、Gemini Pro、Grok 4.6 與 Hakila Auto（另有 Claude Fable 5.1、Haiku 4.5、Gemini Flash、Grok 4.5／4.3 等隱藏條目）
OpenAPI info.version → 1.8.0

2026-10-04

Console 的 Playground 移出，改為獨立站點 Hakila Models：可依 Text／Embedding／Text-to-Speech 瀏覽模型目錄與模型介紹，並試打 Chat 與 TTS 模型（Embeddings 只供瀏覽）；Console 工作區選單不再有「Playground」。說明見快速上手
文件站：頁面右上的「Open」選單移除「Open in GitHub」，保留「View as Markdown」與 AI 工具的開啟選項

2026-10-02

Text-to-Speech：Gemini 回 200 但沒有音訊、finishReason: OTHER 時（gemini-2.5-flash-preview-tts 對短句偶發），Gateway 會原樣自動重送最多 2 次；重送不計費，三次都失敗才回 502，錯誤訊息附上改善建議
允許清單：補充說明 API Key 的自訂允許清單不會自動加入之後上線的新模型；被拒的端點列表補上 /v1/embeddings 與 /v1/audio/speech
Text-to-Speech：新增 azure/mai-voice-2（$22 / 1M 字元）與 azure/mai-voice-2-flash（$15 / 1M 字元），使用 Azure 的 MAI-Voice-2／2.1 語音
Text-to-Speech：Azure 新增延伸欄位 style、style_degree、role，轉成 SSML mstts:express-as 指定說話風格與角色
行為變更：四個 Azure 模型各自只接受自己語音家族的語音（標準 Neural／Dragon 與 DragonHD／MAI-Voice-2／MAI-Voice-2 Flash），不符時回 400 並指出該用的模型；自帶 SSML 的 <voice name> 也會檢查。先前 azure/neural-tts 可呼叫 MAI-Voice 與 Dragon（非 HD）語音，azure/neural-hd-tts 可呼叫標準語音，現在都會被擋下。azure/neural-hd-tts 未帶 voice 時的預設改為 en-US-Tiana:DragonHDFlashLatestNeural

2026-09-30

新增 Text-to-Speech：POST /v1/audio/speech 對齊 OpenAI Audio Speech 規格，支援 OpenAI（原樣轉發，含 stream_format: sse）、Gemini（翻譯成原生 generateContent AUDIO modality，PCM 由 Gateway 封裝成 WAV；支援 speakers 多人對話）、xAI（翻譯成 /v1/tts）與 Azure AI Speech（翻譯成 SSML）；回應為音訊位元組。不支援 hakila/auto、Preset 與 Response Cache
模型類型新增 tts：GET /v1/models 的 type 可為 chat／embedding／tts，用錯端點回 400 並提示正確端點。種子加入 openai/gpt-4o-mini-tts（≈$15 / 1M 字元）、openai/tts-1（$15）、openai/tts-1-hd（$30）、google/gemini-3.1-flash-tts-preview（$1 / $20 per 1M tokens）、google/gemini-2.5-flash-preview-tts（$0.50 / $10）、google/gemini-2.5-pro-preview-tts（$1 / $20）、x-ai/tts（$15 / 1M 字元）、azure/neural-tts（$16）、azure/neural-hd-tts（$22）
TTS 計費：OpenAI／xAI／Azure 以輸入字元數記在 prompt_tokens（單價為 USD / 1M 字元）；Gemini 使用真實 usage（文字輸入 tokens／音訊輸出 tokens）
新增供應商 azure（Azure AI Speech，僅限 tts 類型；Providers:azure:BaseUrl 為區域端點）
Console「系統模型」可選 TTS 類型與 Azure 供應商；TTS 模型不顯示快取單價與 auto 候選，Playground 與 Preset 候選只列出 chat 模型
OpenAPI info.version → 1.7.0

2026-09-29

新增 Embeddings：POST /v1/embeddings 對齊 OpenAI Embeddings 規格，支援 OpenAI（原樣轉發）與 Gemini（翻譯成原生 batchEmbedContents，dimensions／task_type／title 對應帶入）；只以輸入 tokens 計費，支援 Response Cache；不支援 hakila/auto、Preset 與 streaming
模型目錄新增「模型類型」：GET /v1/models 每筆回傳 type（chat／embedding）；用錯端點回 400 並提示正確端點，hakila/auto 候選排除 embedding 模型。種子加入 openai/text-embedding-3-large（$0.13）、openai/text-embedding-3-small（$0.02）、google/gemini-embedding-2（$0.20）、google/gemini-embedding-001（$0.15），單價為 USD / 1M input tokens
Console「系統模型」可設定模型類型；Embeddings 模型不顯示輸出／快取單價與 auto 候選，Playground 只列出 chat 模型
OpenAPI info.version → 1.6.0
模型目錄新增 OpenAI GPT-6 系列：openai/gpt-6-astra（$10 / $50）、openai/gpt-6-sol（$2 / $10）、openai/gpt-6-luna（$0.10 / $0.50），單價為 USD / 1M input／output tokens，context window 1.05M。Responses API 可直接用裸名稱（例如 gpt-6-sol）
hakila/auto 的 OpenAI 候選由 openai/gpt-5.6-luna 改為 openai/gpt-6-luna（既有環境由 migration 自動切換；gpt-5.6-luna 仍可直接指定）
新增 Prompt Cache 用量與計價：usage 回傳 prompt_tokens_details.cached_tokens / cache_write_tokens（Responses 為 input_tokens_details），費用分為一般 prompt、快取讀取、快取寫入、completion 四段計算；模型目錄新增快取讀取／寫入單價
Anthropic 直連改走原生 Messages API（由 Gateway 轉換成 Chat Completions 形狀，含串流），cache_control 與頂層自動快取可直接使用；anthropic-beta header 會轉發
新增 Presets：工作區可把模型、系統提示、參數與 Response Cache 設定存成一組，以 @preset/slug、model@preset/slug 或 preset 欄位引用；找不到或已停用回 400。套用模型可選「全部模型」或自訂 1–3 個（其他模型引用時回 400，沒帶模型時用第一個）
新增 Response Cache：X-Hakila-Cache / X-Hakila-Cache-TTL / X-Hakila-Cache-Clear 請求 header，回應帶 X-Hakila-Cache-Status 等 header；命中不呼叫上游、不計費
預算改為週期制：API Key、人員、單位、組織的預算欄位右側新增週期（每天／每週／每月），達到「本期」累計即回 402，跨期自動重新起算。每天為台北 00:00–24:00、每週為週一至週日、每月為 1 日至月底；既有預算一律視為每月
Admin API 各層級預算輸入新增 budgetPeriod（daily／weekly／monthly），回應新增 periodSpentTwd（本期已用）與 periodResetsAt（下次重算時間）；spentTwd 維持終身累計。層級預算「下層 ≤ 上層」的儲存檢查只在兩層週期相同時進行
用量改以台北日結算：每日 00:00 由 Worker 把當日用量寫入每日明細並歸零，週／月累計為每日明細加當日即時值；已回填 2026-09-14 起的歷史記帳
工作區 BYOK 改版：每家供應商可設定多把金鑰，各自帶標題、Endpoint URL（留空用預設）、生效模型與綁定的 Hakila API Key；條件符合時改用該金鑰呼叫上游。既有工作區金鑰自動搬遷為「既有金鑰」
工作區 BYOK 不再提供自動選模（TypeSafe）金鑰設定，一律使用平台金鑰
新增 POST /v1/responses/input_tokens：對齊 OpenAI，用與建立回應相同的 input 計算 token 數，不產生回應、不計費
路由、允許清單與錯誤形狀與 POST /v1/responses 相同（只支援 OpenAI；裸模型名稱會正規成 openai/...）
OpenAPI info.version → 1.5.0（1.4.0 為同日稍早的 input_tokens 版本）

2026-09-28

typesafe/* 不再出現在 GET /v1/models，也不接受在 Chat Completions／Responses 直接指名（回 400）
hakila/auto 改為依請求內容選模：先把整個請求交給內部選模服務挑一個候選，失敗時退回候選順序，不影響請求成敗也不額外計費
API Reference 移除線上試打（Try it）；Hakila.Api 的 CORS 不再放行 https://docs.hakila.ai

2026-09-25

新增 OpenAI 相容的 Responses API：POST /v1/responses、GET／DELETE /v1/responses/{id}、 POST /v1/responses/{id}/cancel、GET /v1/responses/{id}/input_items
只路由 OpenAI；沒有前綴的 model（例如 gpt-5.6-luna）會正規成 openai/...，官方 SDK 只換 base_url 即可使用
hakila/auto 在此端點的候選限縮為 OpenAI；非 OpenAI 模型回 400 並指向 /v1/chat/completions
記帳只認建立回應一次：background 在 queued 時不計費，之後 retrieve 拿到 usage 才補記（以 response id 去重）
DELETE 與 cancel 跳過預算檢查，超支時仍可止住背景任務
Responses 端點的錯誤改用 OpenAI 形狀（message／type／param／code）；Chat Completions 不變
OpenAPI info.version → 1.3.0

2026-09-21

模型目錄加入 typesafe/jev-latest、typesafe/jev-1.13.0；Chat Completions 指定 TypeSafe 模型會回 400
GET /v1/models 改為回傳平台已啟用目錄 ∩ 組織 ∩ API Key 允許清單；未登錄的 id 一律回 400
文件補上允許清單 400 文案、自訂／地端端點，以及 502 金鑰訊息（Secret Manager／BYOK／自訂端點）
OpenAPI info.version → 1.2.0

2026-09-17

對齊 Hakila.Api Gateway：補上 504 首字元逾時；402 文件涵蓋組織儲值硬閘門與人員／單位預算訊息
BYOK 解析順序改為 Workspace → Tenant → 全域 → 設定檔後備（先前誤寫設定檔優先於 DB）
概念頁澄清 API Key 可選綁定 UnitId／PersonId；Admin 正式網址改為 https://console.hakila.ai
OpenAPI：info.version → 1.0.2；Chat 請求僅強制 model；402／504 回應範例補齊
修正 API Reference Try it：拿掉易被填成空物件的 tools／response_format 表單欄位；Gateway 轉發前會清掉缺少 type 的 tools

2026-09-16

組織層級／人員管理只設定單位與人員預算，不再從組織頁發行 API Key；金鑰改由 /app/{workspaceId}/keys 建立
API Key 仍可選綁定 PersonId／UnitId 供用量歸屬與層級預算（非移除綁定欄位）

2026-09-15

文件對齊 Hakila.Api：Admin 預算以 BudgetTwd（NTD）進出，Gateway 內部仍以 USD 累計（1 USD = 33 TWD）
概念頁補上組織單位／目錄人員，以及 API Key 可選綁定 PersonId
模型範例與 OpenAPI 對齊現行 ModelCatalog／hakila/auto 候選（如 openai/gpt-5.6-luna）
補上 hakila/auto 無法選路的 502 錯誤訊息
OpenAPI info.version → 1.0.1；文件站套件 → 0.0.27

2026-09-10

初版文件站上線（Fumadocs + 手寫 OpenAPI）
涵蓋 GET /v1/models、POST /v1/chat/completions
指南：模型路由、Streaming、BYOK、用量與預算

本頁目錄