跳到主要内容

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

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

延伸阅读