概述
云开发 AI 提供基于混元大模型的文生图和图生图能力，通过文本描述或参考图片即可生成高质量图片。
支持的模型
| 模型名称 | 状态 | 说明 |
|---|---|---|
hy-image-v3.5-preview | 当前版本 | Hy-Image-3.5-preview，Chat/Messages 协议，支持多模态输入、多轮编辑，最高 4K 输出，需 @cloudbase/js-sdk >= 3.11.0 |
HY-Image-3.0-Plus-4090-Tob-v1.0 | 已废弃 | 混元文生图 v3.0，参数见历史版本（旧模型） |
HY-Image-v3.0-I2I-ToB-v1.0.1 | 已废弃 | 混元图生图 v3.0，参数见历史版本（旧模型） |
旧模型废弃通知
hunyuan-image 旧模型（HY-Image-3.0-Plus-4090-Tob-v1.0、HY-Image-v3.0-I2I-ToB-v1.0.1）已废弃，请迁移到 hy-image-v3.5-preview（cloudbase provider），迁移说明见 Hy-Image-3.5-preview 与升级指南。
支持的尺寸
| 方式 | 说明 |
|---|---|
size | 宽高均在 [256, 8192]，面积不超过 4096x4096（4K） |
generate_max_pixels | 1048576（1K）、2359296（1.5K，默认）、4194304（2K） |
| 都不传 | 模型基于 prompt 语义自主决定，默认 1.5K 档 |
参数说明
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | 固定为 hy-image-v3.5-preview |
messages | Array<object> | 是 | 会话内容，文本与参考图以内容块形式混排 |
size | string | 否 | 图片尺寸，传入即强制按该尺寸出图 |
seed | integer | 否 | 生成种子，[0, 2^63-1] |
footnote | string | 否 | 右下角水印，最长 16 字符 |
完整参数与多轮编辑说明见 Hy-Image-3.5-preview。
调用方式
图片生成支持以下调用方式：
- 文生图 — 文本提示词生图
- 图生图 — 参考图与多轮编辑
- 自定义水印 —
footnote参数 - JS SDK 调用 — Node.js 服务端调用
- 小程序调用 — 适合微信小程序内直接生图
- wx-server-sdk 调用 — 适合微信小程序云函数场景
- Node SDK 调用 — 适合云函数、云托管等 Node.js 服务端场景
使用限制
- 小程序端直接调用需要基础库 3.17.4 或更高版本；Web 端浏览器暂不支持直接调用，需通过云函数中转
- 生成的图片 URL 12 小时后失效，如需永久保存请上传至云存储
- 参考图单图不超过 20MB，最多 20 张
- 建议将云函数超时时间设置为 900 秒
计费说明
- 小程序成长计划用户：使用计划赠送的生图资源，无额外费用
- 资源点套餐用户：使用套餐内资源点抵扣
常见问题
如何提升生图质量？
- 编写更详细具体的 prompt，包含风格、色调、构图等描述
- 用
image_url传入参考图，或通过多轮编辑逐步调整 - 固定
seed便于对比不同 prompt 的效果
为什么生成时间较长？
图片生成本身耗时较长，通常需要 10-30 秒，4K 输出更久。请确保云函数超时时间设置足够长。
生成的图片 URL 过期了怎么办？
图片 URL 有效期为 12 小时。建议在云函数中生成图片后立即上传至云存储获取永久 fileID，具体方法参见 JS SDK 调用中的"保存图片到云存储"章节。