跳至主要内容

官方平台 API Key 配置

本文说明如何在 OpenAI、Anthropic、Google Gemini、DeepSeek、MiniMax、Moonshot 的官方开放平台獲取 API Key,并配置到 Mystilink Agent 中使用。

前提

Mystilink 不托管大模型。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-4ogpt-4o-minio3-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-20250514claude-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-flashgemini-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-chatdeepseek-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-8kmoonshot-v1-32kmoonshot-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触发廠商速率或配额限制,稍后重试或升级套餐
網路超时检查是否需要代理;部分廠商需特定網路环境

更多排查见 大模型連接问题

延伸阅读