跳到主要内容

hunyuan-image 生图模型参数说明

云开发 AI 提供的 hunyuan-image 生图模型支持通过文本描述生成图片，本文介绍该模型支持的参数。

支持的参数​

参数名类型必选说明
promptstring是用来生成图像的文本描述
modelstring是模型名称，使用 hunyuan-image
sizestring否图片尺寸，默认 1024x1024
reviseboolean否是否对 prompt 进行改写，默认 true
footnotestring否自定义水印内容，限制 16 个字符
seednumber否生成种子，范围 [1, 4294967295]

参数详解​

size 图片尺寸​

  • 默认值：1024x1024
  • 支持自定义尺寸：宽高需在 768-1280 之间，且为 64 的倍数
  • 如果输入数字不为 64 的倍数，会向上取最接近 64 的倍数，再按中心点剪裁到目标尺寸

常用尺寸：

  • 1024x1024 - 正方形（默认）
  • 1024x768 - 横向
  • 768x1024 - 纵向

revise 提示词改写​

  • 默认值：true
  • 开启后，模型会自动优化您的 prompt，多数场景可提升生成效果
  • 如果希望严格按照原始 prompt 生成，可设置为 false

footnote 水印​

  • 限制 16 个字符（中英文均算 1 个字符）
  • 水印生成在图片右下角
  • 可用于添加品牌标识或版权信息

seed 生成种子​

  • 仅当生成图片数为 1 时生效
  • 范围：1 至 4294967295
  • 不传时随机
  • 相同的 seed + prompt 可以生成相似的图片，用于结果复现

调用示例​

小程序云函数调用​

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

exports.main = async (event) => {
  const ai = cloud.extend.AI;
  
  const result = await ai.createImage({
    model: 'hunyuan-image',
    prompt: '一只可爱的橘猫在阳光下打盹',
    size: '1024x1024',
    revise: true,
    footnote: '云开发生成'
  });
  
  return result;
};

Node.js SDK 调用​

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

const result = await app.ai.createImage({
  model: 'hunyuan-image',
  prompt: '一只可爱的橘猫在阳光下打盹',
  size: '1024x1024',
  revise: true
});

常见错误​

400 Bad Request​

传入了不支持的参数时会返回 400 错误。请确保只使用上述表格中列出的参数。

注意：style 参数当前不支持，请勿传入。

相似问题​

  1. hunyuan-image 支持哪些参数？
  2. 生图模型如何设置图片尺寸？
  3. hunyuan-image 的 revise 参数是什么意思？
  4. 如何在生成的图片上添加水印？
  5. 生图模型 seed 参数有什么用？
  6. hunyuan-image 报错 400 怎么解决？
  7. 云开发 AI 生图支持哪些尺寸？
  8. 如何复现相同的生图结果？
  9. hunyuan-image 生图模型调用示例？
  10. 生图模型 style 参数为什么报错？

相关文档​