模型允許清單
組織與 API Key 如何決定 GET /v1/models 與可呼叫的模型
Hakila 不會把平台上每一個模型都開放給每一把金鑰。實際能用的集合是：
平台已啟用目錄 ∩ 組織允許清單 ∩ API Key 允許清單GET /v1/models 回傳的就是這個交集。未出現在清單中的 model，POST /v1/chat/completions、POST /v1/responses、POST /v1/responses/input_tokens、POST /v1/embeddings 與 POST /v1/audio/speech 都會回 400。
三層規則
| 層級 | 在哪裡設定 | 效果 |
|---|---|---|
| 平台目錄 | 系統管理「模型」 | 未啟用或未登錄的 id 無法路由。種子目錄含 GPT-6 / GPT-5.6、Gemini 3.x、Claude 5、Grok 4.x；也可加自訂／地端端點 |
| 組織 | Admin「模型允許清單」 | 未設定＝允許平台目前（與之後新增）的全部已啟用模型。一旦勾選，就只開放被勾的模型 |
| API Key | 工作區「API Keys」 | 預設 跟隨組織。可改為 自訂允許清單，再從組織已允許的模型中縮小範圍 |
開發用、沒有綁組織的金鑰不會再套組織／金鑰限制，仍須是平台目錄中的已啟用模型。
自訂允許清單只包含當時勾選的模型。之後平台新上線的模型（例如新的 TTS 或 Embeddings 模型）不會自動加入，
呼叫時會回 模型 '…' 未被此 API Key 允許。。要讓金鑰自動取得新模型，請改回「跟隨組織」；
要維持自訂，則需到工作區「API Keys」→ 該金鑰的「允許的模型」勾選新模型後儲存，儲存後立即生效。
對 API 的意義
curl https://api.hakila.ai/v1/models \
-H "Authorization: Bearer $HAKILA_API_KEY"- 請以這支 API 的回傳為準，不要假設某個
provider/model一定存在 - 同一組織裡，不同 API Key 可能看到不同清單
hakila/auto只要平台有啟用就會出現在清單中（自動選路別名）。真正會被嘗試的候選，仍須通過上述交集；沒有候選時呼叫 auto 會回400
被拒時的訊息
| 訊息 | 原因 |
|---|---|
模型 '…' 不在允許清單中。 | 平台目錄沒有這個 id |
模型 '…' 目前未開放使用。 | 目錄有此 id，但已停用 |
模型 '…' 未被此組織允許。 | 組織允許清單未包含它 |
模型 '…' 未被此 API Key 允許。 | 金鑰為自訂模式，且未勾選它（常見於自訂清單設定後才上線的新模型） |
hakila/auto 沒有符合允許清單的候選模型。 | auto 的候選全部被組織／金鑰排除 |
HTTP status 皆為 400。詳見 錯誤碼。
與路由的關係
允許清單只決定「能不能用這個 id」。通過之後，仍依 模型與路由 轉發到對應上游。