用途:在 Node.js 服务端调用 CloudBase AI 模型,适用于云函数、CloudRun、Express/Koa/NestJS 服务、Serverless API 与定时任务。若为网页前端聊天界面应改用 ai-model-web,微信小程序改用 ai-model-wechat,非 CloudBase SDK 运行时改用 http-api-cloudbase。
主要能力:文本生成、流式输出、图像生成(仅 Node SDK 支持,入口为 ai.createImageModel("hunyuan-image")),以及服务端智能体编排、批处理与定时任务。
使用方式:安装 npm install @cloudbase/node-sdk,版本需 >= 3.16.0。云函数内用 tcb.init({ env }) 后取 app.ai();普通 Node 服务需额外传 secretId、secretKey。createModel 只接受三种合法值:"cloudbase"(主托管组)、"hunyuan-exp"(旧内置组)或以 custom- 开头的自定义组名;具体模型写入 model 字段,如 { model: "deepseek-v4-flash" }。
调用前须完成两步预检:先用 envQuery 获取 EnvId,再通过 callCloudApi(service="tcb", action="DescribeEnvPostpayPackage") 确认 Token Credits 资源包有效;随后用 DescribeAIModels 检查目标组与模型是否已启用,缺失时用 DescribeManagedAIModelList 查权威目录与价格,再以 UpdateAIModel(Models 为全量替换、Status: 1)启用。
限制:模型默认均未启用,不可假设已开启;不得猜测模型名或 SDK 方法,需查 api-reference.md 或实时接口。云函数需设置更长超时:文本与流式建议 60–120 秒,图像生成建议 900 秒;HTTP 函数网关上限 60 秒,需改用异步任务加轮询。自定义模型计费由第三方提供方承担,不消耗 Token Credits 资源包。其余细节暂未提供。