# extend.AI

> AI 能力由云开发提供，详细指引请参考[云开发文档](https://docs.cloudbase.net/ai/miniprogram-using)

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

## 一、准备工作

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

小程序基础库在 3.15.1 及以上版本可以调用混元、DeepSeek、GLM、Minimax、Kimi 等最新模型。[点击查看资源包说明](/minigame/dev/wxcloud/billing/package)

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

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

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

## 2.1 初始化云开发环境

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

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

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

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

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

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

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

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

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

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

## 三、更多案例

* [大模型调用](ai/model)
* [Agent 调用](ai/agent)
* [云开发 AI 文档](https://docs.cloudbase.net/ai/introduce)
* [云开发 AI SDK](https://docs.cloudbase.net/ai/sdk-reference/api)
* [FAQ](https://docs.cloudbase.net/ai/FAQ)

更多使用案例指引，可前往[云开发文档](https://docs.cloudbase.net/ai/miniprogram-using)继续阅读。

## 四、常见问题

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

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

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

1. 确认你的小程序通过了企业认证
2. 确认你的环境有效期至少为 3 个月，有助于你通过审核
3. 进入云开发平台[AI+概览页](https://tcb.cloud.tencent.com/dev#/ai?tab=home)，点击帮助文档中的**小程序算法备案** 

![小程序算法备案](https://qcloudimg.tencent-cloud.cn/raw/5c2baa1d524af4ad39b2ba1ecdaf457f.png)

4. 填写你的小程序 AppID 和小程序主体名称
5. 平台将会为你生成算法备案资料

![](https://res.wx.qq.com/op_res/lLg9FqZxGk7HNb_njNy39H2fAkLSi3H_CD5hHvTSJMxrgF57IrV2eaC84fZLnQXzkOi7wITx148gOTByWLIj0g)

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

### 4.2 AI 使用如何定价？

请参考 [计费文档](/minigame/dev/wxcloud/billing/price)

### 4.3 更多问题解答

请参考[常见问题 FAQ](https://docs.cloudbase.net/ai/FAQ)

## 多端框架支持

**多端框架**支持此能力，初始化后可正常调用，初始化指引请参考[此文档](/miniprogram/dev/platform-capabilities/miniapp/new-capability/cloud/cloud.md)