跳到主要内容

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-sdk 3.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 秒。