Minimax大模型接入微信小程序：开发文档与配置流程

想在微信小程序里调用 Minimax 大模型的能力？这件事没法在小程序前端直接搞定，必须借助云函数或自建服务器做中转。下面就把整个接入流程拆开揉碎，一步步说明白。

本文运行环境：MacBook Pro，macOS Sequoia。

一、申请 Minimax API Key 并创建应用

要调用 Minimax 提供的模型服务，首先得拿到 API Key 作为身份凭证。这个 Key 会用在后端向 Minimax 服务器发起请求时的校验环节。

具体操作：访问 https://www.minimaxi.com/console，用邮箱注册账号并完成实名认证。进入「API 密钥管理」页面，点击「创建新密钥」，为应用起个名字，比如「微信小程序后端服务」。创建成功后，复制生成的 api_key 和 group_id，务必妥善保存——这个密钥之后可就再也看不到了。

二、配置云开发环境（腾讯云函数）

微信小程序受限与 request 合法域名白名单和 CORS 策略，不能直接调用外部 HTTPS 接口。所以得把请求逻辑放到云函数里，小程序去调云函数，云函数再转发给 Minimax。

步骤很简单：在微信开发者工具中启用「云开发」，创建一个新环境，等它初始化完。然后在云函数目录右键「新建云函数」，取名 minimax-proxy。接着在云函数根目录的 package.json 里加上依赖："axios": "^1.6.0"。最后在 index.js 里编写请求转发逻辑，别忘了设置 Content-Type: application/json 和 Authorization: Bearer $ 请求头。

三、配置小程序 request 合法域名

如果用云函数，内部通信不涉及 request 域名限制，这一步可以跳过。但如果你打算用自建服务器，那就必须把服务器域名加到小程序后台的「request 合法域名」列表里，否则 wx.request 会被拦截。

做法：登录 微信公众平台 → 「开发管理」→「开发设置」→「服务器域名」。在「request 合法域名」栏输入你的后端服务域名，比如 https://api.yourdomain.com。确保该域名已配置有效 SSL 证书，并且支持 TLS 1.2 及以上协议版本。

四、小程序端调用云函数传递 prompt

小程序前端不直接碰 Minimax API，只把用户输入的文本扔给云函数，云函数负责构造完整请求体并返回结果，这样既安全又隔离。

具体编码：在页面 JS 里调用 wx.cloud.callFunction，传入 name: 'minimax-proxy' 和 data: 。在 success 回调中解析 res.result.response.choices[0].message.content 字段，然后渲染到 WXML 模板。另外，对用户输入做个基础长度校验（建议不超过 2000 字符），避免触发 Minimax 接口的 token 截断机制。

五、处理流式响应与错误码映射

Minimax API 支持 stream=true 参数返回 SSE 流式数据，但云函数默认不支持长连接响应。如果要做类 Chat 场景体验，得改用轮询或 WebSocket 中继方案，或者开启云函数「异步调用」+「临时存储」组合模式。

至于错误处理，有几个关键点：

当 Minimax 返回 429 状态码时，说明 API Key 已达每分钟调用上限。此时在云函数里返回自定义错误码 ERR_RATE_LIMIT，并在小程序端提示用户稍后重试。

当返回 400 且 message 包含 "invalid parameter" 时，检查 prompt 是否为空，或者是否含有非法控制字符（比如 u2028、u2029）。

云函数内还要捕获 axios timeout 异常，统一返回 ERR_BACKEND_TIMEOUT，小程序端显示「服务响应较慢，请重试」即可。