概述
云开发 AI 提供基于混元大模型的文生图能力，通过文本描述即可生成高质量图片。
支持的模型
| 模型名称 | 说明 |
|---|---|
hunyuan-image-v3.0-v1.0.4 | 混元文生图 v3.0，支持自定义尺寸、prompt 改写、thinking 模式 |
旧模型下线通知
hunyuan-image 旧模型将于 2026 年 6 月 30 日 0 点下线，请尽快切换到 hunyuan-image-v3.0-v1.0.4，详见升级指南。
支持的尺寸
| 尺寸 | 比例 | 说明 |
|---|---|---|
1024x1024 | 1:1 | 正方形（默认） |
1280x720 | 16:9 | 横向宽屏 |
720x1280 | 9:16 | 纵向竖屏 |
1280x1280 | 1:1 | 正方形（大尺寸） |
参数说明
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称，使用 hunyuan-image-v3.0-v1.0.4 |
prompt | string | 是 | 图片描述文本，最多 500 字 |
size | string | 否 | 图片尺寸，默认 1024x1024，可选值见上表 |
revise | { value: boolean } | 否 | 是否开启 prompt 改写，开启后模型会自动优化提示词以提升生图效果 |
enable_thinking | { value: boolean } | 否 | 是否开启 thinking 模式，开启后生图质量更高但耗时更长（约增加 60 秒） |
调用方式
图片生成支持以下调用方式：
- 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 调用文档中的"保存图片到云存储"章节。