跳至主要內容

官方平台 API Key 設定

本文說明如何在 OpenAI、Anthropic、Google Gemini、DeepSeek、MiniMax、Moonshot 的官方開放平台取得 API Key，並設定到 Mystilink Agent 中使用。

前提

本文針對 BYOK（自備廠商 Key）。若使用 Newton LLM，無需設定第三方 Key。BYOK 的 API Key 僅儲存在你的本機裝置，請求從你的電腦直連廠商，不會上傳到 Mystilink 伺服器。概覽見 大模型與廠商。

在 Agent 中設定的通用步驟​

無論哪家廠商，推薦在桌面端按以下流程操作（設定 → 大模型 → 新增模型）：

  1. 選擇 Provider — 在下拉列表中選擇對應官方模板（如 OpenAI、Anthropic…）。
  2. 填寫憑證 — 貼上 API Key 字面值，或填寫本機環境變數名（如 OPENAI_API_KEY）。
  3. （可選）覆寫 Base URL — 多數官方模板已內建預設地址；僅在走代理閘道時才需要修改。
  4. 測試連接 — 點擊 測試連接，確認邊框與文案顯示成功後再繼續。
  5. 選擇模型 ID — 從聯想列表選取，或手動輸入廠商文件中的模型 ID。
  6. 補充顯示名稱並儲存 — 儲存後可在列表中將其設為 主模型。

若尚未新增對應 Provider，可先在 大模型 分區底部使用官方模板 新建 Provider，再執行上述「新增模型」流程。

OpenAI​

項目說明
官方平台OpenAI Platform
取得 KeyAPI Keys 頁面
Mystilink 模板OpenAI
預設 Base URLhttps://api.openai.com/v1
常見模型 IDgpt-4o、gpt-4o-mini、o3-mini 等

取得 API Key​

  1. 前往 OpenAI Platform 並登入或註冊帳戶。
  2. 進入 Settings → API keys（或直接打開 API Keys 頁面）。
  3. 點擊 Create new secret key，為 Key 命名（便於區分用途）。
  4. 立即複製生成的 Key（形如 sk-...）——關閉彈窗後將無法再次查看完整金鑰。

設定到 Agent​

  1. 設定 → 大模型，選擇 Provider OpenAI。
  2. 在憑證欄貼上 API Key，點擊 測試連接。
  3. 模型 ID 填寫如 gpt-4o，儲存後設為主模型即可使用。
備註

OpenAI 帳戶需綁定有效支付方式後，部分模型才可調用。用量與計費以 OpenAI 控制台為準。

Anthropic​

項目說明
官方平台Anthropic Console
取得 KeyAPI Keys 設定頁
Mystilink 模板Anthropic
預設 Base URLhttps://api.anthropic.com/v1
常見模型 IDclaude-sonnet-4-20250514、claude-opus-4-20250514 等

取得 API Key​

  1. 前往 Anthropic Console 並完成註冊與驗證。
  2. 打開 Settings → API Keys。
  3. 點擊 Create Key，命名後生成金鑰。
  4. 複製 Key（通常以 sk-ant- 開頭）並妥善儲存。

設定到 Agent​

  1. 選擇 Provider Anthropic，貼上 API Key。
  2. 測試連接通過後，輸入 Claude 模型 ID（以 Anthropic 文件為準）。
  3. 儲存並設為主模型。
資訊

Anthropic 使用獨立的 API 協議（非 OpenAI 相容）。請在 Mystilink 中選擇 Anthropic 官方模板，不要誤選 OpenAI 模板。

Google Gemini​

項目說明
官方平台Google AI Studio
取得 KeyAPI Key 管理頁
Mystilink 模板Google Gemini
預設 Base URLhttps://generativelanguage.googleapis.com/v1beta
常見模型 IDgemini-2.0-flash、gemini-1.5-pro 等

取得 API Key​

  1. 使用 Google 帳戶登入 Google AI Studio。
  2. 進入 API Key 頁面。
  3. 點擊 Create API key，選擇關聯的 Google Cloud 專案（可按提示新建）。
  4. 複製生成的 Key 並儲存。

設定到 Agent​

  1. 選擇 Provider Google Gemini，貼上 API Key。
  2. Gemini 模板不支援覆寫 Base URL，請直接使用預設地址。
  3. 測試連接後選擇模型 ID（如 gemini-2.0-flash），儲存即可。

DeepSeek​

項目說明
官方平台DeepSeek Platform
取得 Key登入後在控制台 API Keys 分區建立
Mystilink 模板DeepSeek
預設 Base URLhttps://api.deepseek.com/v1
常見模型 IDdeepseek-chat、deepseek-reasoner

取得 API Key​

  1. 前往 DeepSeek Platform 註冊並登入。
  2. 進入控制台，找到 API Keys（或「API 金鑰」）分區。
  3. 建立新 Key，複製以 sk- 開頭的金鑰。

設定到 Agent​

  1. 選擇 Provider DeepSeek，貼上 API Key，測試連接。
  2. 模型 ID 推薦 deepseek-chat（對話）或 deepseek-reasoner（推理）。
  3. 儲存後設為主模型。
提示

DeepSeek 採用 OpenAI 相容 API。若你使用第三方 DeepSeek 代理，也可參考 OpenAI 相容供應商設定。

MiniMax​

項目說明
官方平台MiniMax 開放平台
取得 Key登入後在控制台建立 API Key
Mystilink 模板MiniMax
預設 Base URLhttps://api.minimax.io/v1
常見模型 ID以控制台或 API 文件 為準

取得 API Key​

  1. 前往 MiniMax 開放平台 註冊帳戶。
  2. 在控制台找到 API Key 或 金鑰管理，建立新 Key。
  3. 複製 Key；部分帳戶還需在控制台開通對應模型權限或充值。

設定到 Agent​

  1. 選擇 Provider MiniMax，填寫 API Key。
  2. 測試連接；若支援模型發現，可點擊 發現模型 刷新列表。
  3. 選擇或輸入模型 ID 後儲存。
備註

若你使用國內版 MiniMax 開放平台，Base URL 與 Key 取得入口可能與國際版不同，請以你實際簽約平台的文件為準，並在 Mystilink 中覆寫對應的 Base URL。

Moonshot（Kimi）​

項目說明
官方平台Moonshot AI 開放平台
取得 Key登入後在控制台 API Key 分區建立
Mystilink 模板Moonshot
預設 Base URLhttps://api.moonshot.ai/v1
常見模型 IDmoonshot-v1-8k、moonshot-v1-32k、moonshot-v1-128k 等

取得 API Key​

  1. 前往 Moonshot AI 開放平台 註冊並登入。
  2. 進入控制台，在 API Key 頁面建立金鑰。
  3. 複製 Key 並儲存；確認帳戶已開通 API 調用權限並完成實名/充值（若平台要求）。

設定到 Agent​

  1. 選擇 Provider Moonshot，貼上 API Key，測試連接。
  2. 按 Moonshot 文件選擇合適上下文長度的模型 ID。
  3. 儲存並設為主模型。

使用環境變數（可選）​

若不想在介面中直接貼上 Key，可在本機設定環境變數，再在 Mystilink 憑證欄填寫變數名（而非 Key 本身）：

# macOS / Linux（示例）
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export DEEPSEEK_API_KEY="sk-..."

從終端或系統環境啟動 Mystilink 桌面端後，Agent 會讀取對應變數。修改環境變數後需重啟應用。

常見問題​

現象處理
測試連接 401Key 無效或已撤銷，請在官方平台重新生成
404 / model not found核對模型 ID 拼寫與帳戶是否有該模型權限
429觸發廠商速率或配額限制，稍後重試或升級套餐
網路超時檢查是否需要代理；部分廠商需特定網路環境

更多排查見 大模型連接問題。

延伸閱讀​