API Reference
Hakila Gateway 公開 API 的互動式參考文件
以下頁面由 openapi/hakila-v1.yaml 自動產生。參數、Schema 與範例請以 OpenAPI 為準，勿在此重複維護。
列出模型
GET /v1/models
Chat Completions
POST /v1/chat/completions
Responses
POST /v1/responses（OpenAI 相容，可呼叫所有 chat 模型）
計算 input tokens
POST /v1/responses/input_tokens
Messages
POST /v1/messages（Anthropic 相容，所有 chat 模型）
Embeddings
POST /v1/embeddings（OpenAI 相容，支援 OpenAI 與 Gemini）
Text-to-Speech
POST /v1/audio/speech（OpenAI 相容，支援 OpenAI、Gemini、xAI 與 Azure）
正式環境 Base URL：https://api.hakila.ai（本機：http://localhost:5100）。
GET /v1/models 已套用這把 API Key 的允許清單；請以該清單中的 id 呼叫 Chat、Responses、Embeddings 或 Text-to-Speech。每筆模型帶 type：chat 走 Chat／Responses，embedding 走 Embeddings，tts 走 /v1/audio/speech。
Workspace
Organization、Workspace 與 Gateway 資源的關係
列出可用模型 GET
回傳這把 API Key **實際可用**的模型。來源是平台已啟用的目錄（AllowedModels）， 再與組織允許清單 ∩ API Key 允許清單取交集。 - 模型 id 使用 `開發商/模型名稱` 命名（例如 `openai/gpt-5.6-luna`），前綴是開發商，不是實際提供服務的供應商 - `type` 為 `chat`（文字生成，走 Chat / Responses）、`embedding`（向量，走 `POST /v1/embeddings`）、 `tts`（文字轉語音，走 `POST /v1/audio/speech`）或 `image`（生圖，走 `POST /v1/images`） - `architecture.output_modalities` 標示輸出類型；可用 `?output_modalities=image` 只列生圖模型（逗號分隔多個值） - `hakila/auto` 只要平台有啟用就會出現（自動選路別名）；實際候選仍受允許清單限制，且只會落在 chat 模型 - 不在平台目錄的 id 回 `404`；在目錄但未被允許的 id 回 `400` - 不帶前綴的名稱：目錄中剛好一個同名模型時補上開發商前綴；有多個時回 `400` 並列出候選；沒有時回 `404`；`auto` 一律回 `400` - 每個模型可用的供應商用 `GET /v1/models/{author}/{slug}/endpoints` 查詢 - 目錄內容由平台維運，種子資料涵蓋 GPT-6 / GPT-5.6、Gemini 3.x、Claude 5、Grok 4.x、 `text-embedding-3-*` 與 `gemini-embedding-*`，`gpt-4o-mini-tts`、`tts-1`、Gemini TTS、`x-ai/tts`， 以及 GPT Image、Nano Banana、FLUX.3、Seedream 5、Recraft V4.1 等生圖模型；請以此端點為準