用途
本技能用于指导开发者通过腾讯云 CloudBase 调用 AI 模型，适用于跨平台的 AI 能力接入。技能明确列出支持平台：Web（浏览器）使用 @cloudbase/js-sdk；Node.js（服务端/云函数）使用 @cloudbase/node-sdk（≥3.16.0）；任意平台可通过 HTTP API 或 OpenAI SDK 调用；微信小程序使用 wx.cloud.extend.AI。
主要能力
技能覆盖三类核心能力：文本生成（generateText，非流式）、流式文本生成（streamText）以及图像生成（generateImage）。文本生成返回文本、消息历史与 token 用量；流式生成支持增量文本流与完整数据流；图像生成目前仅 Node SDK 可用，返回图片 URL（有效期 24 小时）。
使用方式
技能建议编码代理先确认目标平台、CloudBase 环境 ID 与凭证，再选择对应章节，并严格遵循 CloudBase API 形态，不要自行发明新 API。
安装方面：Web 端执行 npm install @cloudbase/js-sdk；Node.js 端执行 npm install @cloudbase/node-sdk，且 AI 功能要求版本 3.16.0 以上。
初始化方面：Web 端通过 cloudbase.init 传入 env 与 accessKey，随后进行匿名登录并调用 app.ai()；Node.js 端通过 tcb.init 传入 env，在云函数中调用 app.ai()。
调用示例：使用 ai.createModel("hunyuan-exp") 创建模型后，可调用 generateText 传入 model 与 messages；streamText 可迭代 textStream 或 dataStream，并获取最终 messages 与 usage；图像生成使用 ai.createImageModel("hunyuan-image") 并传入 prompt、size、version 等参数。
HTTP API 方面：端点为 https://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/<PROVIDER>/v1/chat/completions，支持 cURL 非流式与流式调用，也可通过 OpenAI SDK 兼容方式接入，需设置 apiKey 与 baseURL。
微信小程序方面：需基础库 3.7.1 以上，无需额外 SDK。初始化使用 wx.cloud.init。generateText 返回原始模型响应，需通过 res.choices[0].message.content 访问；streamText 参数必须包裹在 data 对象中，并支持 onText、onEvent、onFinish 回调，也可异步迭代 textStream 或 eventStream，流式结束需检查 event.data === "[DONE]"。
适用场景
适用于需要在 Web、Node.js 服务端/云函数、HTTP 接口或微信小程序中接入 CloudBase AI 文本生成、流式对话与图像生成的开发场景。
限制
图像生成目前仅 Node SDK 支持，JS SDK（Web）与微信小程序不可用。微信小程序 API 与 JS/Node SDK 不同，参数结构与返回值存在差异，需注意区分。Node SDK AI 功能要求版本 3.16.0 以上。API Key 不应暴露在客户端代码中。