用途：调用腾讯云混元 3.0 生图模型（经 CloudBase AI 网关），提供文生图与垫图（参考图改图）能力，适合需要混元/腾讯云出图或走微信小程序生态、使用「小程序成长计划」激励资源包额度的场景。不想配置或不走该生态时，资料建议改用免注册的 freeimg-z-image。
使用方式：首次需在微信公众平台「行业能力 → 小程序成长计划」免费领取资源包（10 万张 AI 生图 + 10 亿 Token，6 个月有效），创建云开发环境并记录环境 ID；再到腾讯云控制台「访问管理 → API 密钥管理」新建密钥。凭据按环境变量 TCB_ENV_ID / TCB_SECRET_ID / TCB_SECRET_KEY，或配置文件 ~/.freeimg-hunyuan/config.env 读取，后者建议 chmod 600。
配置示例：mkdir -p ~/.freeimg-hunyuan && printf "TCB_ENV_ID=你的环境ID\nTCB_SECRET_ID=你的SecretId\nTCB_SECRET_KEY=你的SecretKey\n" > ~/.freeimg-hunyuan/config.env && chmod 600 ~/.freeimg-hunyuan/config.env
生成示例：scripts/generate.mjs --prompt "提示词" --out 输出.jpg [--size 1024x1024] [--no-revise] [--footnote "品牌名"]；垫图加 --image 垫图.jpg。尺寸仅支持 1024x1024 / 1280x720 / 720x1280 / 2048x512，提示词上限 4000 字，默认自动润色，可用 --no-revise 关闭。
限制：无资源包时按量计费；密钥须妥善保管，勿写入仓库或对话；422 为内容审核失败，需改措辞；输出为 JPEG，--out 前缀建议用 .jpg。脚本依赖 @cloudbase/node-sdk，首次运行自动安装至 ~/.freeimg-hunyuan/sdk，需本机有 node + npm。生成后建议先查看图片再交付，签名 URL 会过期，脚本已落盘为本地文件。