必须完成四项前置准备：获取并保管tokenhub api key、开通腾讯云混元服务、安装python 3.12+运行环境、确认准确模型标识，缺一不可。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在本地或第三方工具中成功调用腾讯混元大模型，必须先完成四项不可跳过的前置准备，缺一不可——没有 API 密钥无法鉴权，没有开通服务会直接返回 403 错误，未安装运行环境会导致脚本启动失败，未确认模型标识则可能调用到错误版本甚至报错 model not found。
获取并保管好 TokenHub API Key
登录腾讯云控制台，访问 TokenHub 控制台 → 确保已开通 TokenHub 服务 → 进入「API Key 管理」页面 → 点击「创建 API Key」→ 填写名称（如 WorkBuddy-Hunyuan），访问范围务必【全选】 → 创建后立即复制保存密钥，该密钥【仅显示一次】，丢失需重新生成且旧密钥自动失效。
确认混元服务已开通
前往腾讯云混元大模型服务页面，点击「立即开通服务」。这一步不能跳过，即使已有 TokenHub API Key，若未单独开通混元服务，所有请求都会返回「ServiceNotEnabled」错误码。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
准备好 Python 运行环境
确保本地已安装 Python 3.12 或更高版本。WorkBuddy 的 MCP Server 脚本依赖 asyncio、httpx 等模块，低版本 Python 会触发 SyntaxError 或 ModuleNotFoundError。执行 python --version 验证，输出应为 Python 3.12.x 或 3.13.x。
明确你要接入的模型标识
方法一：对接 OpenRouter 平台时，使用模型 ID tencent/hy3-preview（Hy3 preview 免费期已于 2026 年 7 月 21 日结束，当前需确认是否续期或切换至正式版）；
方法二：直连腾讯云原生接口时，模型 ID 必须严格匹配官方列表，例如 hunyuan-pro、hunyuan-standard 或最新发布的 hy4-preview；
方法三：在 CherryStudio 等客户端中添加模型时，模型 ID 必须与混元产品文档中公布的完全一致，大小写敏感，多一个空格或短横线都会导致「model not found」。
