快速上手
取得 API Key 並送出第一個 Chat Completions 請求
本頁示範如何在五分鐘內串接 Hakila Gateway。
1. 取得 API Key
在 Hakila Admin 後台建立 Workspace API Key。金鑰只會在建立當下顯示一次明文，請妥善保存。
請求時使用：
Authorization: Bearer <your-api-key>想先不寫程式試用，可以到 Hakila Models：依 Text／Embedding／Text-to-Speech 瀏覽模型目錄與模型介紹， 並直接對 Chat 與 TTS 模型送出請求。以 Console 帳號登入後可選用自己工作區的 API Key，也可以手動貼上 API Key （只保留在該瀏覽器分頁 15 分鐘）。在 Models 站送出的請求與直接呼叫 API 一樣計費，並套用相同的允許清單與預算檢查。
2. 列出模型
curl https://api.hakila.ai/v1/models \
-H "Authorization: Bearer $HAKILA_API_KEY"3. 送出第一個 Chat 請求
curl https://api.hakila.ai/v1/chat/completions \
-H "Authorization: Bearer $HAKILA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5.6-luna",
"messages": [{"role":"user","content":"hi"}]
}'重點
- SDK 只要改
base_url/baseURL指向 Hakila，其餘與官方 OpenAI SDK 用法相同 GET /v1/models回傳的是這把金鑰實際可用的模型，不是平台全部目錄（見 允許清單）model必須是清單中的 id（見 模型與路由）- 需要串流時加
"stream": true（見 Streaming） - 需要 OpenAI 的 Responses 契約時改打
POST /v1/responses；只算 token 用POST /v1/responses/input_tokens（見 Responses API）