Hakila Docs
Models

列出可用模型

回傳這把 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 等生圖模型；請以此端點為準

GET/v1/models

回傳這把 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 等生圖模型；請以此端點為準

Authorization

bearerAuth
AuthorizationBearer <token>

在 Authorization 標頭帶入 Workspace API Key： Authorization: Bearer sk-hakila-...

In: header

Query Parameters

output_modalities?string

只列出輸出類型符合的模型（text、image、audio、embeddings，逗號分隔）。

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/models"
{  "data": [    {      "id": "hakila/auto",      "name": "Hakila: Auto",      "context_length": 2000000,      "owned_by": "hakila",      "type": "chat"    },    {      "id": "openai/gpt-5.6-luna",      "name": "OpenAI: GPT-5.6 Luna",      "context_length": 1050000,      "owned_by": "openai",      "type": "chat"    },    {      "id": "google/gemini-3.8-flash",      "name": "Google: Gemini 3.8 Flash",      "context_length": 1048576,      "owned_by": "google",      "type": "chat"    },    {      "id": "anthropic/claude-sonnet-5",      "name": "Anthropic: Claude Sonnet 5",      "context_length": 1000000,      "owned_by": "anthropic",      "type": "chat"    },    {      "id": "openai/text-embedding-3-small",      "name": "OpenAI: Text Embedding 3 Small",      "context_length": 8192,      "owned_by": "openai",      "type": "embedding"    },    {      "id": "google/gemini-embedding-2",      "name": "Google: Gemini Embedding 2",      "context_length": 8192,      "owned_by": "google",      "type": "embedding"    }  ]}

API Reference

Hakila Gateway 公開 API 的互動式參考文件

查詢模型的供應商 GET

格式同 OpenRouter `/api/v1/models/{author}/{slug}/endpoints`。依預設選路順序列出這把 API Key 可用的供應商， 已套用組織的供應商限制。 - `provider` 是請求 `provider` 欄位可用的供應商代號 - `pricing` 為每 token 的 USD 單價（字串）；有快取計價時另有 `input_cache_read`、`input_cache_write` - `status` 為 `paused` 表示這個模型經該供應商短時間內連續失敗，目前自動暫停（仍會作為最後的備援） - 見[多供應商與備援](/docs/guides/models#多供應商與備援)