# extend.AI

AI 能力由云开发提供，详细指引请参考云开发文档

本文介绍小程序如何使用 wx.cloud.extend.AI 能力

# 一、准备工作

注册一个微信小程序账号，并且创建本地小程序工程项目

小程序基础库需要在 3.7.1 及以上版本，具备 wx.cloud.extend.AI 对象

小程序需要开通「云开发」，可在小程序开发工具中点击工具栏里的「云开发」按钮进行开通，并创建环境（PS：对于首次使用云开发的用户，第一个月套餐免费）：

# 二、调用大模型，实现文本生成

在小程序中，直接调用大模型的文本生成能力，实现最简单的文本生成。这里以一个“七言绝句”生成器的简单 Demo 为例：

# 2.1 初始化云开发环境

在小程序代码中，通过以下代码进行云开发环境初始化：

wx.cloud.init({
  env: "<云开发环境ID>",
});

其中 <云开发环境ID> 需替换为实际云开发环境 ID。初始化成功后，就可使用 wx.cloud.extend.AI 调用 AI 能力。

# 2.2 创建 AI 模型，并调用生成文本

在小程序基础库 3.7.1 及以上，小程序端的代码如下：

// 创建模型实例，这里我们使用 DeepSeek 大模型
const model = wx.cloud.extend.AI.createModel("deepseek");

// 我们先设定好 AI 的系统提示词，这里以七言绝句生成为例
const systemPrompt =
  "请严格按照七言绝句或七言律诗的格律要求创作，平仄需符合规则，押韵要和谐自然，韵脚字需在同一韵部。创作内容围绕用户给定的主题，七言绝句共四句，每句七个字；七言律诗共八句，每句七个字，颔联和颈联需对仗工整。同时，要融入生动的意象、丰富的情感与优美的意境，展现出古诗词的韵味与美感。";

// 用户的自然语言输入，如‘帮我写一首赞美玉龙雪山的诗’
const userInput = "帮我写一首赞美玉龙雪山的诗";

// 将系统提示词和用户输入，传入大模型
const res = await model.streamText({
  data: {
    model: "deepseek-r1", // 指定具体的模型
    messages: [
      { role: "system", content: systemPrompt },
      { role: "user", content: userInput },
    ],
  },
});

// 接收大模型的响应
// 由于大模型的返回结果是流式的，所以我们这里需要循环接收完整的响应文本。
for await (let str of res.textStream) {
  console.log(str);
}
// 输出结果：
// "# 咏玉龙雪山\n"
// "皑皑峻岭入云巅，玉骨冰肌傲九天。\n"
// "雪影岚光添胜景，神山圣境韵绵绵。\n"

# 三、更多案例

更多使用案例指引，可前往云开发文档继续阅读。

# 四、常见问题

# 4.1 小程序中使用了 Extend.AI 能力，如何准备备案材料？

AI 问答涉及深度合成技术，需补充【深度合成-AI 问答】服务类目。

目前，个人主体小程序尚未开放深度合成相关服务类目，建议申请企业主体类型小程序。

确认你的小程序通过了企业认证
确认你的环境有效期至少为 3 个月，有助于你通过审核
进入云开发平台首页，点击右上角小程序算法备案
填写你的小程序 AppID 和小程序主体名称
平台将会为你生成算法备案资料

前往微信开发者平台，提交上一步生成的备案资料页的清晰截图
你可以在服务类目中选择深度合成>AI 问答/AI 换脸/AI 绘画，选择 2.2 深度合成服务《在用证明》（证明须含【小程序主体】、【小程序 appid】、【订单有效期】、【算法备案号】等内容），将截图上传到微信开发者平台，保证图片清晰可见）

# 4.2 AI 使用如何定价？

按照实际调用产生的 Token 数量计费，新用户可以赠送 100 万 Token，如需更多，请联系客服进行提升。

# 4.3 首月免费到期之后如何收费?

首月免费试用期结束后，云开发的收费将依据云开发基础套餐标准执行。具体费用详情请参考定价文档。

# 4.4 更多问题解答

请参考常见问题 FAQ