微信小程序调用minimax大模型需通过云函数或服务器中转，不可前端直连；步骤包括申请api key、配置云函数、设置合法域名、小程序调用及错误处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在微信小程序中调用 Minimax 大模型提供的 AI 能力，需通过 Minimax 官方 API 接口实现，不能直接在小程序前端发起请求，必须借助云函数或自有服务器中转。以下是完成接入的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、申请 Minimax API Key 并创建应用
Minimax 提供的模型服务需通过 API Key 进行身份认证，开发者需在 Minimax 开放平台注册账号并获取合法凭证。该 Key 将用于后端服务向 Minimax 服务器发起请求时的身份校验。
1、访问 https://www.minimaxi.com/console，使用邮箱注册并完成实名认证。
2、进入「API 密钥管理」页面，点击「创建新密钥」，填写应用名称为「微信小程序后端服务」。
3、复制生成的 api_key 和 group_id，妥善保存，该密钥不可再次查看。
二、配置云开发环境（腾讯云函数）
微信小程序无法直接调用外部 HTTPS 接口（受限于 request 合法域名白名单及 CORS 策略），因此需将 Minimax 请求逻辑部署至云函数，由小程序调用云函数中转。
1、在微信开发者工具中启用「云开发」，创建新环境并等待初始化完成。
2、右键云函数目录 → 「新建云函数」，命名为 minimax-proxy。
3、在云函数根目录的 package.json 中添加依赖："axios": "^1.6.0"。
4、在云函数 index.js 中编写请求转发逻辑，设置 Content-Type: application/json 与 Authorization: Bearer ${apiKey} 请求头。
三、配置小程序 request 合法域名
云函数调用属于内部通信，不涉及 request 域名限制；但若采用自建服务器方案，则必须将服务器域名添加至小程序后台的「request 合法域名」列表，否则 wx.request 将被拦截。
MiniMax MCP 服务器，提供网络搜索和图像理解能力。当用户需要：(1) 网络搜索信息，(2) 分析/描述图片，(3) 从URL提取内容时使用此技能。需配置 MINIMAX_API_KEY（国内版 api.minimaxi.com 或全球版 api.minimax.io）。
1、登录 微信公众平台 →「开发管理」→「开发设置」→「服务器域名」。
2、在「request 合法域名」栏中添加您的后端服务域名，例如：https://api.yourdomain.com。
3、确保该域名已配置有效 SSL 证书，且支持 TLS 1.2 及以上协议版本。
四、小程序端调用云函数传递 prompt
小程序前端不接触 Minimax API，仅向云函数提交用户输入文本，由云函数构造完整请求体并返回响应结果，实现安全隔离。
1、在页面 JS 文件中调用 wx.cloud.callFunction，传入 name: 'minimax-proxy' 与 data: { prompt: '你好，请简要介绍自己' }。
2、在 success 回调中解析 res.result.response.choices[0].message.content 字段，渲染至 WXML 模板。
3、对用户输入做基础长度校验（建议 ≤ 2000 字符），避免触发 Minimax 接口的 token 截断机制。
五、处理流式响应与错误码映射
Minimax API 支持 stream=true 参数返回 SSE 流式数据，但云函数默认不支持长连接响应；如需类 Chat 场景体验，应改用轮询或 WebSocket 中继方案，或启用云函数「异步调用」+「临时存储」组合模式。
1、当 Minimax 返回状态码为 429 时，表示当前 API Key 已达每分钟调用上限，需在云函数中返回自定义错误码 ERR_RATE_LIMIT 并提示用户稍后重试。
2、当 Minimax 返回 400 且 message 包含 "invalid parameter" 时，检查 prompt 是否为空或含非法控制字符（如 \u2028\u2029）。
3、云函数内捕获 axios timeout 异常，统一返回 ERR_BACKEND_TIMEOUT，小程序端显示「服务响应较慢，请重试」。
