文生图

hy-image-v3.5-preview 通过 Chat/Messages 协议根据文本提示词生成图片，支持自定义尺寸（最高 4096x4096）、生成种子与水印。

模型

使用 hy-image-v3.5-preview 模型，provider 为 cloudbase，需要 @cloudbase/js-sdk >= 3.11.0。

参数说明

参数	类型	必选	说明
model	string	是	固定为 hy-image-v3.5-preview
messages	Array<object>	是	会话内容，role=user 的 content 中放文本
size	string	否	尺寸 ${宽}x${高}，传入即强制按该尺寸出图
seed	integer	否	生成种子，[0, 2^63-1]，固定后可复现结果
generate_max_pixels	integer	否	面积档位，仅在未传 size 时生效
footnote	string	否	右下角水印，最长 16 字符

完整参数（session、resize_max_pixels、use_search_tool）与返回值说明见 Hy-Image-3.5-preview。

支持的尺寸

方式	说明
size	宽高均在 [256, 8192]，面积不超过 4096x4096，最高 4K
generate_max_pixels	1048576（1K）、2359296（1.5K，默认）、4194304（2K）
都不传	模型基于 prompt 语义自主决定，默认 1.5K 档

使用示例

const imageModel = ai.createImageModel("cloudbase");

const res = await imageModel.generateImage({
  model: "hy-image-v3.5-preview",
  size: "4096x4096",
  seed: 42,
  footnote: "CloudBase AI",
  messages: [
    {
      role: "user",
      content: [{ type: "text", text: "一只胖胖的橘猫坐在窗台上打盹，水彩风格，温暖色调" }],
    },
  ],
});

// 最终交付图片，URL 12 小时内有效
console.log(res.choices[0].delta.image.url);

调用方式

• JS SDK 调用 — Node.js 服务端
• Hy-Image-3.5-preview — 完整协议与参数参考
• 历史版本（旧模型） — 已废弃的 HY-Image-3.0 用法