建立 Chat Completion

對齊 OpenAI Chat Completions 規格。`model` 必須是平台目錄中已啟用、且通過組織 ∩ API Key 允許清單的 id。 - Gateway 強制驗證 `model`；`messages` 請一併帶入（文件 Try it 與實務皆需要） - 設定 `"stream": true` 時以 SSE（`text/event-stream`）回傳 - 轉發時把 model id 換成該供應商的上游模型名稱 - 同一模型有多家供應商時，依平台優先順序 → `provider` 偏好 → 組織供應商限制 → 金鑰（BYOK 優先）挑選， 429／5xx 等錯誤且尚未開始回應時自動改送下一家；費用依實際供應商單價計算（見[多供應商與備援](/docs/guides/models#多供應商與備援)） - 回應 header `x-hakila-provider` 標示實際提供服務的供應商；非 streaming 回應的 JSON 另有 `provider` 欄位 - 未知欄位會盡可能透傳給上游（pass-through）；空的 `tools`／`response_format`／`tool_choice` 會在轉發前移除 - `hakila/auto` 會先把請求內容交給內部選路模型，從通過允許清單的 auto candidate 中挑一個； 選路失敗時退回候選順序中第一個有上游金鑰者 - 上游首字元逾時（預設 30 秒）回傳 `504` - `model` 可引用工作區 Preset：`@preset/slug` 或 `openai/gpt-4o@preset/slug`，也可用 `preset` 欄位（見 [Presets](/docs/guides/presets)） - `usage.prompt_tokens_details` 回報 Prompt Cache 讀取／寫入 tokens（見 [Prompt Cache](/docs/guides/prompt-cache)） - `X-Hakila-Cache: true` 啟用 Response Cache，命中時不呼叫上游、不計費（見 [Response Cache](/docs/guides/response-cache)）

curl -X POST "https://example.com/v1/chat/completions" \  -H "Content-Type: application/json" \  -d '{    "model": "openai/gpt-5.6-luna",    "messages": [      {        "role": "user",        "content": "用一句話介紹 Hakila"      }    ]  }'

{  "id": "chatcmpl-example",  "object": "chat.completion",  "created": 1710000000,  "model": "gpt-5.6-luna",  "provider": "openai",  "choices": [    {      "index": 0,      "message": {        "role": "assistant",        "content": "Hakila 是統一的 AI Gateway。"      },      "finish_reason": "stop"    }  ],  "usage": {    "prompt_tokens": 12,    "completion_tokens": 8,    "total_tokens": 20,    "prompt_tokens_details": {      "cached_tokens": 0,      "cache_write_tokens": 0    }  }}