概述
云开发 AI 提供基于混元大模型的文生图和图生图能力，通过文本描述或参考图片即可生成高质量图片。
支持的模型
| 模型名称 | 说明 |
|---|---|
HY-Image-3.0-Plus-4090-Tob-v1.0 | 混元文生图 v3.0，支持自定义尺寸、prompt 改写、thinking 模式 |
HY-Image-v3.0-I2I-ToB-v1.0.1 | 混元图生图 v3.0，支持传入垫图作为参考进行图像生成 |
旧模型下线通知
hunyuan-image 旧模型将于 2026 年 7 月 15 日 0 点下线，请尽快切换到 HY-Image-3.0-Plus-4090-Tob-v1.0，详见升级指南。
支持的尺寸
| 尺寸 | 比例 | 说明 |
|---|---|---|
1024x1024 | 1:1 | 正方形（默认） |
1280x720 | 16:9 | 横向宽屏 |
720x1280 | 9:16 | 纵向竖屏 |
1280x1280 | 1:1 | 正方形（大尺寸） |
参数说明
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称，使用 HY-Image-3.0-Plus-4090-Tob-v1.0 |
prompt | string | 是 | 图片描述文本，最多 500 字 |
size | string | 否 | 图片尺寸，默认 1024x1024，可选值见上表 |
revise | { value: boolean } | 否 | 是否开启 prompt 改写，开启后模型会自动优化提示词以提升生图效果 |
enable_thinking | { value: boolean } | 否 | 是否开启 thinking 模式，开启后生图质量更高但耗时更长（约增加 60 秒） |
图生图参数
HY-Image-v3.0-I2I-ToB-v1.0.1 模型在文生图参数基础上，额外支持以下垫图参数：
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
image_urls | list<string> | 否 | 垫图 url 列表，与 image 二选一，优先选 image，大小不超过 10MB，支持 jpg、jpeg、png 格式，最多 1 张图，image_urls 和 images 必有一个非空 |
images | list<string> | 否 | 垫图 base64 列表，与 image_url 二选一，优先选 image，大小不超过 10MB，支持 jpg、jpeg、png 格式，最多 1 张图 |
调用方式
图片生成支持以下调用方式：
- wx-server-sdk 调用 — 适合微信小程序云函数场景
- Node SDK 调用 — 适合云函数、云托管等 Node.js 服务端场景
使用限制
- 图片生成仅支持服务端调用（云函数/云托管 ），小程序端和 Web 端需通过云函数中转
- 生成的图片 URL 24 小时后失效，如需永久保存请上传至云存储
- prompt 最长 500 字
- 建议将云函数超时时间设置为 900 秒（开启 revise 约增加 10 秒，开启 thinking 最长增加 60 秒）
计费说明
- 小程序成长计划用户：使用计划赠送的生图资源，无额外费用
- 资源点套餐用户：使用套餐内资源点抵扣
常见问题
如何提升生图质量？
- 开启
revise让模型优化你的 prompt - 开启
enable_thinking让模型进行更深入的理解（耗时更长） - 编写更详细具体的 prompt，包含风格、色调、构图等描述
为什么生成时间较长？
图片生成本身耗时较长，通常需要 10-30 秒。开启 revise 或 enable_thinking 会额外增加耗 时。请确保云函数超时时间设置足够长。
生成的图片 URL 过期了怎么办？
图片 URL 有效期为 24 小时。建议在云函数中生成图片后立即上传至云存储获取永久 fileID，具体方法参见各 SDK 调用文档中的"保存图片到云存储"章节。