用途：在前端 Web 应用中调用 AI 模型，基于 @cloudbase/js-sdk，实现文本生成与流式输出。适用于 React/Vue/Angular、静态网站与单页应用；不适用于 Node.js 后端或云函数（改用具 ai-model-nodejs 技能）、微信小程序（ai-model-wechat）、图片生成（仅 Node SDK）以及 HTTP API 集成（http-api）。
主要能力：CloudBase 内置提供两类模型。hunyuan-exp 提供 hunyuan-turbos-latest、hunyuan-t1-latest、hunyuan-2.0-thinking-20251109、hunyuan-2.0-instruct-20251111，推荐 hunyuan-2.0-instruct-20251111；deepseek 提供 deepseek-r1-0528、deepseek-v3-0324、deepseek-v3.2，推荐 deepseek-v3.2。提供非流式 generateText 与流式 streamText 两种调用方式，可获取生成文本、完整消息历史、token 用量与原始响应。
使用方式：安装 npm install @cloudbase/js-sdk。同步初始化：cloudbase.init({ env: "<YOUR_ENV_ID>", accessKey: "<YOUR_PUBLISHABLE_KEY>" })，其中 accessKey 来自 CloudBase 控制台；随后进行匿名登录 await auth.signInAnonymously()，再获取 app.ai()。generateText 通过 ai.createModel(provider) 后传入 model、messages 调用，返回 result.text、result.usage、result.messages、result.rawResponses。streamText 可迭代 res.textStream 获取增量文本，或迭代 res.dataStream 获取完整数据块，也可 await res.messages 与 res.usage 获取最终结果。输入支持 model、messages 必填，temperature、topP 可选；消息角色支持 user、system、assistant。
最佳实践与限制：长响应建议使用流式；用 try/catch 处理错误；accessKey 应使用可发布密钥而非密钥；SDK 在应用入口尽早初始化；调用 AI 前必须完成用户认证，否则无法使用 AI 功能。