# 把 MiniMax 装进 WorkBuddy：自定义模型接入完整教程（M3 / M2.5 / M2.5 High Speed）

> 适用版本：WorkBuddy 桌面版（2026-10）。全文示例中的 API Key 均为占位符，请替换为你自己平台的密钥。

## 一、为什么要接自定义模型

WorkBuddy 内置了混元、GLM、Kimi、DeepSeek 等模型，按积分倍率计费。但如果你手里已经有第三方大模型平台的额度（比如 MiniMax 开放平台的 Token Plan，或者你自己订阅的 API），把这些模型接进来就有两个直接好处：

1. **消耗你自己的 API 额度**，不占 WorkBuddy 积分；
2. **模型随便挑**——同一系列里不同速度、不同价位的变体，按任务切换。

MiniMax 就是个好例子：标准版便宜、High Speed 版快一倍、M3 最新最全能。这篇教程把它们一次性接好。

## 二、准备工作：拿到 MiniMax 的 API Key

1. 注册并登录 MiniMax 开放平台，在「账号管理 → API Key」里创建一个密钥；

> ⚠️ 一个容易踩的坑：MiniMax **国内平台（minimaxi.com）和国际平台（minimax.io）账号不互通、Key 不通用**。注册的是哪个，下面供应商就选哪个，混用会一直 401。

## 三、接入步骤（图形界面，全程 1 分钟）

1. 打开 WorkBuddy **设置 → 模型**，点「添加模型」；
2. **供应商**下拉选 `MiniMax 中国版`（或国际版）——选完请求地址、能力标记自动填充，**不需要手填 URL**；
3. 粘贴 **API Key**，点右侧「测试连接」验证一下；
4. **模型名称**下拉直接选——列表由官方同步（当前截图里有 M3、M2.5、M2.5 High Speed、M2.1、M2.1 High Speed、M2）；想用的型号不在下拉里也不用慌，**模型名称支持手动输入**，填官方模型 ID 即可（如 `MiniMax-M2.7`、`MiniMax-M2.7-highspeed`）；
5. 保存。重复 2-4 可以把多个变体都接进来。

![screenshot1.png](https://developer.qcloudimg.com/http-save/yehe-11453218/3c8e9229cdbeb2f8abd650434d8135cc.png)

6. 回到对话界面，点输入栏的模型名称，选择器里出现 MiniMax 分组，切换即用。

![screenshot2.png](https://developer.qcloudimg.com/http-save/yehe-11453218/9f1605301cbc3aee3f12c0cdb1f7f7f8.png)

> 提示：老版本用配置文件（`~/.codebuddy/models.json`）添加过的模型，升级后仍可在设置界面里查看、编辑或删除，不用迁移。

## 四、型号怎么选

下拉列表里的型号按"新一代 / 标准 / High Speed"分三档：

| | M3 | M2.5 | M2.5 High Speed |
| --- | --- | --- | --- |
| 定位 | 最新一代，多模态+智能体任务强 | 能力均衡，日常主力 | M2.5 的加速版 |
| 上下文 | 大（以官网为准） | 约 200K | 与标准版相同 |
| 输出速度 | — | 约 60 token/s | 约 100 token/s（官方口径） |
| 价格 | 以官网为准 | 便宜 | 约为标准版 2 倍 |
| 适合场景 | 代码、Agent、看图 | 日常问答写作 | 长输出、要"吐字快"的交互 |

经验判断：**High Speed 和标准版是同一个模型**，只优化了推理引擎、智能不打折——差别就是价格翻倍买速度。写长报告、生成长代码用 High Speed 体感提升明显；短任务用标准版省钱。M3 留给需要视觉输入或复杂智能体任务的场合。M2.1 / M2 是上代型号，新接入不建议选。

## 五、常见问题

**Q1：保存后对话里找不到模型？**  
设置里确认该模型已启用；部分版本需要重启 WorkBuddy 刷新模型列表。

**Q2：报 401 / invalid api key？**  
检查 Key 是否带多余空格；确认请求地址和你注册的平台一致（国内 `api.minimaxi.com` ≠ 国际 `api.minimax.io`，两边账号不互通）。

**Q3：能不能接入别的厂商（DeepSeek / Moonshot / OpenRouter…）？**  
能，只要是 OpenAI 兼容接口，方法完全一样——换地址、Key、模型名三个字段即可。各家模型列表路径略有差异，拿不准就先在浏览器打开 `你的地址/models` 看能不能列出模型。

**Q4：接进来的模型能干活吗（调工具、读写文件）？**  
可以，WorkBuddy 对自定义模型同样提供工具调用；支持 function calling 的模型（MiniMax M2.5 / M3 都支持）就能跑完整的 Agent 任务。

## 六、小结

WorkBuddy 的自定义模型入口比想象中简单：**设置 → 模型 → 自定义 API，三个字段，一分钟一个模型**。把 MiniMax 全家桶接进来之后，我现在的分工是：日常用 M2.5，长文输出切 M2.5 High Speed，带图的活儿上 M3——你们还想接什么模型，评论区聊聊。

---

适用版本：WorkBuddy 桌面版（2026-10）。全文示例中的 API Key 均为占位符，请替换为你自己平台的密钥。

把 MiniMax 装进 WorkBuddy：自定义模型接入完整教程（M3 / M2.5 / M2.5 High Speed）

WorkBuddy 设置里选 MiniMax 供应商、贴 Key、选型号，一分钟接入自定义模型。M3 / M2.5 / M2.5 High Speed 三个变体怎么选、国内国际站别搞混、401 排查，一篇讲清。

开发工具

后端

人工智能

WorkBuddy自定义模型接入教程，详解将MiniMax M3/M2.5/M2.5HighSpeed接入WorkBuddy桌面版。步骤包含获取APIKey、选择供应商、测试连接及模型切换，支持官方同步下拉与手动输入模型ID。重点区分国内/国际平台Key不通用，并解析型号选择策略、常见401错误修复及OpenAI兼容接口扩展方法。

智能体

WorkBuddy 

DeepSeek

Agent

2026上云采购 | AI焕新·智启新局

workbuddy

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

WorkBuddy自定义模型接入教程，详解将MiniMax M3/M2.5/M2.5HighSpeed接入WorkBuddy桌面版。步骤包含获取APIKey、选择供应商、测试连接及模型切换，支持官方同步下拉与手动输入模型ID。重点区分国内/国际平台Key不通用，并解析型号选择策略、常见401错误修复及OpenAI兼容接...

把 MiniMax 装进 WorkBuddy：自定义模型接入完整教程（M3 / M2.5 / M2.5 High Speed）-腾讯云开发者社区-腾讯云

把 MiniMax 装进 WorkBuddy：自定义模型接入完整教程（M3 / M2.5 / M2.5 High Speed）

把 MiniMax 装进 WorkBuddy：自定义模型接入完整教程（M3 / M2.5 / M2.5 High Speed）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐