跳到主要内容

混元文生图模型升级指南

小程序成长计划一期赠送的生图资源当前使用 hunyuan-image 模型，该模型将于 2026 年 6 月 30 日 0 点下线。

请在下线前完成升级，将模型切换到 hunyuan-image-v3.0-v1.0.4。如到期未完成切换，系统将自动将模型切换到 hunyuan-image-v3.0-v1.0.4。

升级后，小程序成长计划赠送的生图额度可继续在 hunyuan-image-v3.0-v1.0.4 上使用。

涉及的模型​

旧模型名称新模型名称
hunyuan-imagehunyuan-image-v3.0-v1.0.4

新模型 hunyuan-image-v3.0-v1.0.4 相比旧模型支持自定义宽高比、prompt 改写和 thinking 改写模式，生图质量更高。

改造方式​

图片生成功能仅支持在云函数（Node.js SDK）中调用。修改 generateImage 的 model 参数即可完成升级：

使用 @cloudbase/node-sdk​

改造前：

const cloudbase = require('@cloudbase/node-sdk');
const app = cloudbase.init({ env: process.env.ENV_ID });
const ai = app.ai();

exports.main = async (event) => {
  const { prompt } = event;

  const imageModel = ai.createImageModel('hunyuan-image');
  const res = await imageModel.generateImage({
    model: 'hunyuan-image',
    prompt,
  });

  return { url: res.data[0].url };
};

改造后：

const cloudbase = require('@cloudbase/node-sdk');
const app = cloudbase.init({ env: process.env.ENV_ID });
const ai = app.ai();

exports.main = async (event) => {
  const { prompt } = event;

  const imageModel = ai.createImageModel('hunyuan-image');
  const res = await imageModel.generateImage({
    model: 'hunyuan-image-v3.0-v1.0.4',
    prompt,
    size: '1024x1024',                    // 可选，支持自定义宽高比
    revise: { value: true },              // 可选，开启 prompt 改写
    enable_thinking: { value: true },     // 可选，开启 thinking 模式
  });

  return { url: res.data[0].url };
};

使用 wx-server-sdk​

改造前：

const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })

exports.main = async (event, context) => {
  const imageModel = cloud.ai().createImageModel('hunyuan-image')
  const res = await imageModel.generateImage({
    model: 'hunyuan-image',
    prompt: event.prompt,
  })
  return { url: res.data[0].url }
}

改造后：

const cloud = require('wx-server-sdk')

cloud.init({
  env: cloud.DYNAMIC_CURRENT_ENV,
  timeout: 150000,   // 单次 HTTP 请求超时 150s，覆盖 @cloudbase/node-sdk 默认的 ~15s
})

const ALLOWED_SIZES = ['1024x1024', '1280x720', '720x1280', '1280x1280']

exports.main = async (event, context) => {
  const prompt = (event.prompt || '').trim()
  if (!prompt) {
    return { error: '请输入提示词' }
  }
  if (prompt.length > 500) {
    return { error: '提示词最多 500 字' }
  }

  const size = ALLOWED_SIZES.includes(event.size) ? event.size : '1024x1024'

  const imageModel = cloud.ai().createImageModel('hunyuan-image')
  const res = await imageModel.generateImage({
    model: 'hunyuan-image-v3.0-v1.0.4',
    prompt,
    size,
    revise: { value: false },
    enable_thinking: { value: false },
  })

  return {
    url: res.data[0].url,                         // 图片 URL，24 小时有效
    revisedPrompt: res.data[0].revised_prompt,    // 优化后的提示词
  }
}

新模型支持更多参数，详见 Node SDK 调用 和 wx-server-sdk 调用。

获取帮助​

如升级过程中遇到问题，可前往 云开发社区 提问，或提交工单获取 1v1 支持。