跳到主要内容

官方平台 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触发厂商速率或配额限制，稍后重试或升级套餐
网络超时检查是否需要代理；部分厂商需特定网络环境

更多排查见 大模型连接问题。

延伸阅读​