Hakila Docs

Changelog

Hakila API 與文件的變更紀錄

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

維護慣例

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

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 /api/v1/models、POST /api/v1/chat/completions
  • 指南：模型路由、Streaming、BYOK、用量與預算

建立 Chat Completion POST

對齊 OpenAI Chat Completions 規格。請求 body 會依 `model` 前綴路由至對應上游供應商。 - 設定 `"stream": true` 時以 SSE（`text/event-stream`）回傳 - 直連供應商時會自動剝除 model id 的 provider 前綴再轉發 - 未知欄位會盡可能透傳給上游（pass-through） - `hakila/auto` 依可用金鑰嘗試：OpenAI → Gemini → Claude → Grok → OpenRouter

本頁目錄

維護慣例2026-09-152026-09-10