JS SDK 调用
通过 @cloudbase/js-sdk 调用 hy-image-v3.5-preview(cloudbase provider),无需通过云函数中转。
注意
图片生成依赖 @cloudbase/js-sdk >= 3.11.0,且仅限在服务端环境(Node.js)中使用。Web 端浏览器不支持直接调用,需通过 Node SDK 创建云函数中转。
前置条件
- 已开通云开发环境
@cloudbase/js-sdk3.11.0 或更高版本- 生图资源:小程序成长计划赠送的生图资源
安装
npm install @cloudbase/js-sdk
如需按需引入,还需注册 AI 模块:
import cloudbase from "@cloudbase/js-sdk/app";
import { registerAi } from "@cloudbase/js-sdk/ai";
registerAi(cloudbase);
初始化
import cloudbase from "@cloudbase/js-sdk";
const app = cloudbase.init({
env: "your-env-id",
});
const ai = app.ai();
基本生图
const imageModel = ai.createImageModel("cloudbase");
const res = await imageModel.generateImage({
model: "hy-image-v3.5-preview",
messages: [
{
role: "user",
content: [{ type: "text", text: "一只胖胖的橘猫坐在窗台上打盹,水彩风格,温暖色调" }],
},
],
});
// 最终交付图片,URL 12 小时内有效
const image = res.choices[0].delta.image;
console.log(image.url, image.width, image.height);
cloudbase provider 无需配置 generateImageSubUrlConfig,模型路由由 SDK 内置。
常用参数
const res = await imageModel.generateImage({
model: "hy-image-v3.5-preview",
size: "4096x4096", // 指定尺寸,4K 输出
seed: 42, // 固定种子,相同 seed + prompt + size 可复现
footnote: "Generated by Cloudbase", // 右下角水印,最长 16 字符
session: "demo-session-001", // 多轮编辑时保持一致
messages: [
{ role: "user", content: [{ type: "text", text: "赛博朋克风格的未来城市夜景,霓虹灯光,雨夜" }] },
],
});
参数完整说明(尺寸约束、generate_max_pixels 档位、参考图与多轮编辑)见 Hy-Image-3.5-preview。
多轮编辑
把上一轮响应的 assembled_history 原样追加到 messages,再拼入本轮 user 消息:
const firstMessages = [
{ role: "user", content: [{ type: "text", text: "画一只坐在窗台上的猫" }] },
];
const firstRes = await imageModel.generateImage({
model: "hy-image-v3.5-preview",
session: "demo-session-001",
messages: firstMessages,
});
const secondRes = await imageModel.generateImage({
model: "hy-image-v3.5-preview",
session: "demo-session-001",
messages: [
...firstMessages,
...firstRes.assembled_history,
{ role: "user", content: [{ type: "text", text: "换成布偶猫,背景换成壁炉旁" }] },
],
});
保存图片到云存储
生成的图片 URL 12 小时后失效,建议下载后保存至云存储:
import https from "https";
import cloudbase from "@cloudbase/js-sdk";
const app = cloudbase.init({ env: process.env.ENV_ID });
const ai = app.ai();
async function generateAndSave(prompt) {
const imageModel = ai.createImageModel("cloudbase");
const res = await imageModel.generateImage({
model: "hy-image-v3.5-preview",
messages: [{ role: "user", content: [{ type: "text", text: prompt }] }],
});
const imageUrl = res.choices[0].delta.image.url;
const imageBuffer = await downloadImage(imageUrl);
const uploadRes = await app.uploadFile({
cloudPath: `ai-images/${Date.now()}.jpg`,
fileContent: imageBuffer,
});
return uploadRes.fileID;
}
function downloadImage(url) {
return new Promise((resolve, reject) => {
https.get(url, (response) => {
const chunks = [];
response.on("data", (chunk) => chunks.push(chunk));
response.on("end", () => resolve(Buffer.concat(chunks)));
response.on("error", reject);
});
});
}
超时提示
图片生成耗时较长(4K 输出更久),在云函数中调用时建议将超时时间设置为 900 秒。
相关文档
- Hy-Image-3.5-preview — 模型能力、Chat/Messages 协议参数与返回值
- 历史版本(旧模型) — 已废弃的
hunyuan-image与 HY-Image-3.0 用法 - JS SDK AI 参考 → ImageModel — ImageModel 完整 API 文档
- JS SDK 初始化 — 初始化与鉴权