用途：面向浏览器/Web 前端场景，通过 @cloudbase/js-sdk 在页面中直接调用 AI 模型，无需先搭建 Node.js、云函数或 CloudRun 代理。适用于 React、Vue、Next、Nuxt、静态站点、SPA、仪表盘、AI 聊天 UI 等。若用户明确要求后端/服务端调用、图片生成或需要服务端密钥、长任务，应改用 ai-model-nodejs；微信小程序用 ai-model-wechat；无 CloudBase SDK 的运行时用 http-api-cloudbase。
主要能力：文本生成、流式响应，可从浏览器调用 Hunyuan、DeepSeek、GLM、Kimi、MiniMax 等模型。模型名只影响 model 字段，不影响路由选择。
关键用法：ai.createModel(...) 的参数只能是三种合法形式——"cloudbase"（新项目主托管组，厂商与具体模型写入 generateText/streamText 的 model 字段）、"hunyuan-exp"（仅当 DescribeAIModels 明确返回该旧内置组时）、"custom-<名称>"（通过 CreateAIModel 注册的自定义组，必须以 custom- 开头）。不要写厂商名或模型名作为参数。
调用前需完成两步预检：① 资格检查，用 callCloudApi(service="tcb", action="DescribeEnvPostpayPackage", params={ EnvId }) 确认存在 pkg_tcb_tokencredits_ 开头且状态非 3/4 的 Token Credits 资源包；② 组就绪检查，用 DescribeAIModels 确认目标 GroupName 存在且 Status=1、目标 Model 已启用，缺失时先用 DescribeManagedAIModelList 查权威目录与价格，再用 UpdateAIModel（Models 为全量替换，Status: 1）启用。
安装：npm install @cloudbase/js-sdk。初始化用 cloudbase.init({ env, accessKey })，accessKey 通过 queryAppAuth / manageAppAuth 自动获取并写入 .env.local。登录检查必须用 auth.getSession()，不要用已废弃的 getLoginState()；匿名用户默认被拒绝 AI 模型权限，需真实登录（手机、邮箱、微信、用户名密码等），登录流程由 auth-web-cloudbase 技能负责。
限制：匿名登录不可用于 AI 功能；模型默认未启用，必须先检查再启用；自定义模型计费由第三方提供方承担，不消耗 Token Credits 资源包；内置组不可删除。具体模型清单与价格以 DescribeManagedAIModelList 实时返回为准，不要硬编码。