官方平台 API Key 設定
BYOK 表示使用自己的廠商帳號與 API Key 接入模型。金鑰在 Mystilink 本機設定，模型用量由對應廠商計費。若想使用 Mystilink 帳號與餘額，請看 Newton LLM，無須在這裡新增第三方 Key。
先準備三項資訊
- API Key：由實際提供 API 的廠商開放平台產生；不要填寫網頁登入密碼、Mystilink 啟用碼或聊天產品的登入憑證。
- 模型 ID：必須是目前 API 帳號有權限使用的標識；顯示名稱不一定就是請求使用的 ID。
- API 權限與額度：能登入廠商聊天網頁，不等於該帳號已具備可用 API 額度。請在開放平台確認。
不要把網路範例中的舊模型名稱視為必然可用。優先從目前可用模型清單選擇；手動輸入時逐字核對。
在 Mystilink 中新增
開啟 設定 → 大模型，選擇與服務對應的廠商。填寫 API Key，或依介面支援的方式填寫本機可讀取的環境變數名稱。使用官方服務時，保留範本預設位址；只有明確需要代理或不同端點時，才覆寫 Base URL。
先測試連線，再填寫或選擇模型 ID、補充顯示名稱並儲存。將目標設定設為主模型後，用一則不含私人資料的訊息確認對話能完成。連線測試成功並不保證模型具備完整的 Agent 工具呼叫能力。
廠商與協定
以下是 Mystilink 中對應的範本與官方入口，不是對可用地區、模型或價格的承諾。具體 Key 取得步驟、權限與付費規則以廠商平台為準。
| 廠商 | 官方入口 | Mystilink 範本注意事項 |
|---|---|---|
| OpenAI | API 平台、驗證說明 | 使用 OpenAI 範本；保留預設位址，選擇帳號實際可用的模型 |
| Anthropic | Console、API 文件 | 原生 API 使用 Anthropic 協定，不要當作通用相容閘道填寫 |
| Google Gemini | AI Studio、模型文件 | 使用 Gemini 範本；目前範本不提供 Base URL 覆寫 |
| DeepSeek | 開放平台、API 文件 | 使用 DeepSeek 範本，確認模型與帳號權限 |
| MiniMax | 開放平台 | 使用對應範本；不同區域的帳號、金鑰與位址不要混用 |
| Moonshot / Kimi | 開放平台 | 使用對應範本；模型 ID 與位址應來自同一服務區域與帳號 |
Anthropic
使用官方原生服務時選擇 Anthropic 範本。如果服務商另外提供相容閘道，應使用其公布的相容協定與位址，不能只因為模型名稱包含 Claude 就選原生範本。
Google Gemini
使用 Gemini 範本連接官方原生 API。第三方平台提供的 Gemini 模型可能採用另一種相容協定；應依實際閘道選擇 自訂供應商。
位址、金鑰與模型必須來自同一服務
官方 Key 不一定能用於代理，代理 Key 也不能直接用於官方位址。檢查時應同時確認：誰發放了 Key、請求傳往哪個網域、該帳號可用哪些模型。覆寫位址後，請求內容會傳送到新位址對應的服務。
Base URL 應 填服務的 API 前綴，不要把完整聊天請求路徑或模型詳情網頁貼進去。設定第三方閘道或本機服務見 相容供應商 與 本機模型。
常見問題
| 現象 | 先檢查 |
|---|---|
| 401 / Key 無效 | Key 是否屬於目前位址，是否過期或被撤銷；環境變數能否被應用程式讀取 |
| 模型清單為空 | 帳號權限、模型探索支援；已知準確 ID 時可手動輸入 |
| 404 / model not found | API 前綴與模型 ID，是否把顯示名稱當作 ID |
| 測試成功但任務不能完成 | 工具呼叫、串流輸出及模型能力，不只檢查網路 |
| 額度相關錯誤 | 到實際廠商核對 API 帳單；向 Newton 儲值不會補充第三方額度 |
更多排查見 大模型連線問題。Key 外洩時應在發放平台撤銷並重新設定，不要只修改顯示名稱或刪除截圖。