OpenAI 相容供應商設定
第三方平台、自建閘道或本機服務若提供 Mystilink 支援的相容介面，可以建立自訂 Provider 接入。這裡的「相容」指介面協定，不保證所有模型、功能與驗證方式都相同。
接入前確認
- 服務是否支援所需聊天介面、串流回覆與工具呼叫。
- API 前綴、驗證方式與模型 ID 是否由同一服務提供。
- 若需要特殊請求標頭、簽章、查詢參數或專用端點，目前設定是否支援；不能只改一個 URL 就假定可以使用。
- 該服務會怎樣處理上下文、帳單與金鑰。閘道可能進一步把請求轉給上游廠商。
只有能回傳一般文字，不代表一定能完成排盤工具、問詢等 Agent 流程。
建立自訂 Provider
在 設定 → 大模型 的 Provider 建立入口選擇自訂設定，依介面填寫：
| 欄位 | 怎樣填寫 |
|---|---|
| Provider ID | 本機設定的唯一標識，例如 my-gateway |
| 顯示名稱 | 便於辨識服務來源的名稱 |
| API 協定族 | 服務確實提供該相容協定時，選 openai-compatible |
| Base URL | 官方說明中 的 API 前綴；不要填寫聊天網頁或完整 /chat/completions 請求位址 |
| API Key | 此閘道自己的 Key；驗證要求以服務文件為準 |
| 模型探索 | 服務支援模型清單時啟用；否則使用準確的模型 ID |
儲存 Provider 後，再新增模型設定、測試連線、填寫模型 ID 與顯示名稱，最後確認主模型。參見 大模型與廠商。
位址範例
OpenRouter 官方介面說明 使用的 API 前綴為 https://openrouter.ai/api/v1。模型 ID 應從該帳號可用目錄取得，不能把上游廠商的簡稱直接當作閘道 ID。
其他相容平台或自建服務請使用其目前官方文件中的位址。範例裡的 /v1 不是所有服務都通用的後綴；不要重複補上，也不要自行刪去平台要求的路徑。
能否覆寫官方範本位址
只有確認協定與驗證方式都相符時，才使用「官方範本 + 覆寫 Base URL」。名稱相同的模型也可能透過不同介面提供；例如 Anthropic 原生協定、Gemini 原生協定與通用相容協定不能簡單混用。
Azure 等服務可能需要專門的驗證、API 版本或部署路徑。這裡不提供未經驗證的直連配方；先核對服務與 Mystilink 目前支援的協定是否相符，或使 用明確提供受支援相容介面的閘道。
測試與排查
先傳送不含私人資料的簡短訊息，再確認需要工具的實際任務能否完成。常見問題：
| 現象 | 排查方向 |
|---|---|
| 404 | API 前綴重複、缺路徑，或模型 ID 不存在 |
| 401 / 403 | Key 與閘道不相符、權限不足或驗證方式不支援 |
| 沒有模型清單 | 未開啟探索、服務不支援清單或帳號無權限；核對後手動輸入 |
| 有文字但工具不執行 | 模型或端點工具能力不相符 |
| 回覆中斷或逾時 | 閘道、上游服務、網路及串流輸出支援 |