跳到主要内容

历史版本（旧模型）

模型已废弃

HY-Image-3.0-Plus-4090-Tob-v1.0、HY-Image-v3.0-I2I-ToB-v1.0.1 与 hunyuan-image 旧模型已废弃。新项目请使用 Hy-Image-3.5-preview（cloudbase provider，@cloudbase/js-sdk >= 3.11.0）。

旧模型通过 hunyuan-image provider 调用，需要手动配置 generateImageSubUrlConfig。

文生图​

参数类型必选说明
modelstring是HY-Image-3.0-Plus-4090-Tob-v1.0
promptstring是图片描述文本，最多 500 字
sizestring否图片尺寸，默认 1024x1024
revise{ value: boolean }否是否开启 prompt 改写
seednumber否生成种子，范围 [1, 4294967295]
footnotestring否自定义水印，最长 16 字符

支持的尺寸：1024x1024、1280x720、720x1280、1280x1280。

import cloudbase from "@cloudbase/js-sdk";

const app = cloudbase.init({ env: "your-env-id" });
const ai = app.ai();

const imageModel = ai.createImageModel("hunyuan-image");
imageModel.generateImageSubUrlConfig["hunyuan-image"][
  "HY-Image-3.0-Plus-4090-Tob-v1.0"
] = "images/ar/generations";

const res = await imageModel.generateImage({
  model: "HY-Image-3.0-Plus-4090-Tob-v1.0",
  prompt: "一只胖胖的橘猫坐在窗台上打盹，水彩风格，温暖色调",
  size: "1024x1024",
  revise: { value: true },
});

console.log(res.data[0].url); // 图片 URL，24 小时有效
console.log(res.data[0].revised_prompt); // 改写后的 prompt

图生图​

在文生图参数基础上，额外支持垫图参数：

参数类型必选说明
image_urlslist<string>否垫图 url 列表，与 images 二选一
imageslist<string>否垫图 base64 列表，与 image_urls 二选一，优先级更高
垫图要求
  • 最多 1 张图，大小不超过 10MB
  • 支持 jpg、jpeg、png 格式
const imageModel = ai.createImageModel("hunyuan-image");

const res = await imageModel.generateImage({
  model: "HY-Image-v3.0-I2I-ToB-v1.0.1",
  prompt: "将这张照片转换为油画风格",
  image_urls: ["https://example.com/reference.jpg"],
  revise: { value: true },
});

console.log(res.data[0].url);

自定义水印​

调用 generateImage 时传入 footnote 参数，服务端在生图过程中同步添加水印：

const res = await imageModel.generateImage({
  model: "HY-Image-3.0-Plus-4090-Tob-v1.0",
  prompt: "一只胖胖的橘猫坐在窗台上打盹",
  footnote: "CloudBase AI",
});

console.log(res.data[0].url); // 返回的图片已包含水印
  • 水印生成在图片右下角，最长 16 字符（不区分中英文）
  • 不会额外增加生图时间