跳到主要内容

快速开始

初始化云开发环境​

危险

初始化云开发环境是使用 AI SDK 的必备条件。

在使用 Cloudbase JS SDK 的 AI+ 功能前，请先保证开通了云开发环境并完成了初始化操作，具体请参考：

其中，在初始化小程序端云开发时，合法域名需要再加上 https://{env}.api.tcloudbasegateway.com ，并将 {env} 替换为您的云开发环境 id。

初始化 SDK​

Web​

// 在 Web 项目的根目录下，使用 npm 或 yarn 安装所需的包：
// npm i @cloudbase/js-sdk@2.8.2-beta.0

// 引入 SDK，这里我们引入了完整的 clousebase-js-sdk，也支持分模块引入
import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({
  env: "your-env", // 需替换为实际使用环境 id
});
const auth = app.auth();
await auth.signInAnonymously(); // 或者使用其他登录方式
const ai = await app.ai();
// 接下来就可以调用 ai 模块提供的创建模型等方法了

小程序​

// 在小程序 package.json 所在的目录（一般是 miniprogram 目录）执行命令安装 npm 包：
// npm i @cloudbase/js-sdk@2.8.2-beta.0

// 引入 SDK，这里我们以分模块的形式按需引入了 cloudbase-js-sdk，也支持完整引入
import cloudbase from "@cloudbase/js-sdk/app";
import { registerAuth } from "@cloudbase/js-sdk/auth";
import { registerAi } from "@cloudbase/js-sdk/ai";

registerAuth(cloudbase);
registerAi(cloudbase);
const app = cloudbase.init({
  env: "your-env", // 需替换为实际使用环境 id
});
const auth = app.auth({ persistence: "local" });
await auth.signInWithOpenId(); // 或者使用其他登录方式
const ai = await app.ai();
// 接下来就可以调用 ai 模块提供的创建模型等方法了

使用大模型生成文本​

const hy = ai.createModel("hunyuan"); // 创建模型
const res = await hy.generateText({
  model: "hunyuan-lite",
  messages: [
    { role: "user", content: "你好，请你介绍一下李白" },
  ],
});
console.log(res.text)

以流式使用大模型生成文本​

const hy = ai.createModel("hunyuan"); // 创建模型
const res = await hy.streamText({
  model: "hunyuan-lite",
  messages: [
    { role: "user", content: "你好，请你介绍一下李白" },
  ],
});
for await (let str of res.textStream) {
  console.log(str);
}
如何知道流式传输何时完成？

在 for await 循环语句后的代码只会在流式传输完成后才执行，所以我们可以很简单地得知流式传输已经完成了：

console.log("流式传输开始！");
for await (let str of res.textStream) {
  console.log(str);
}
console.log("流式传输结束！");