用途:在微信小程序环境中调用 AI 模型,入口为 wx.cloud.extend.AI。适用于小程序内 AI 文本生成、带回调的流式响应,以及从微信环境调用混元等模型。不适用于浏览器/Web 应用、Node.js 后端或云函数、图片生成,以及无 CloudBase SDK 的原生应用、Python 等运行时。
主要能力:提供 generateText 非流式生成与 streamText 流式生成(支持 onText、onEvent 等回调)。前置要求为微信基础库 3.7.1+,无需额外安装 SDK,通过 wx.cloud.init({ env: "<YOUR_ENV_ID>" }) 初始化。
关键用法:wx.cloud.extend.AI.createModel(provider) 的 provider 即 DescribeAIModels 返回的 GroupName,只有三种合法形态:"hunyuan-exp"(已加入小程序成长计划的环境)、"cloudbase"(默认托管组,具体厂商与模型放在 model 字段)、"custom-<your-name>"(自定义组,须以 custom- 开头)。写入厂商名或模型 ID 均属错误,模型 ID 应放在 data 的 model 字段。
调用前须完成两步前置检查:①计费资格(先查小程序成长计划 ai_miniprogram_inspire_plan 是否加入,命中用 hunyuan-exp 与 hunyuan-2.0-instruct-20251111;否则走 Token Credits 资源包并用 cloudbase 组);②组就绪(用 DescribeAIModels 查看已启用模型;缺失时先用 DescribeManagedAIModelList 查权威目录,再用 UpdateAIModel 且 Status:1 启用;注意 Models 为全量替换)。次序不可颠倒。
自定义接入:托管目录外的第三方/自建 OpenAI 兼容端点,可经控制台或 CreateAIModel 注册 Type=custom 的组,GroupName 须以 custom- 开头。
限制:cloudbase 组默认未启用任何模型,需显式检查与启用;不同环境是否有相应计费资格需按流程核验;小程序端不支持图片生成。