用途：调用腾讯云混元 3.0 生图模型（走 CloudBase AI 网关），支持文生图与垫图（图生图）。额度来自微信「小程序成长计划」激励资源包，10 万张 AI 生图 + 10 亿 Token，6 个月有效，绑定在自建云开发环境上；无资源包时按量计费。
主要能力：文生图、参考图改图；可选尺寸仅 1024x1024、1280x720、720x1280、2048x512（上游限制宽高 512–2048 且面积不超过 1024x1024）；提示词上限 4000 字，支持中文；默认开启模型自动润色，可用 --no-revise 关闭；--footnote 添加右下角水印文字（≤16 字符，默认空格为无水印，去水印合规责任在使用方）；429/5xx 内置 2 秒重试一次。
使用方式：先领取激励资源包并创建云开发环境，记下环境 ID；在腾讯云控制台访问管理新建 API 密钥，取得 SecretId 与 SecretKey；写入 ~/.hunyuan/config.env（chmod 600）或使用环境变量 TCB_ENV_ID、TCB_SECRET_ID、TCB_SECRET_KEY。脚本依赖官方 @cloudbase/node-sdk，首次运行自动安装到 ~/.hunyuan/sdk，需本机有 node 与 npm。生成命令：scripts/generate.mjs --prompt "提示词" --out 输出.png [--size 1024x1024] [--no-revise] [--footnote "品牌名"]；垫图加 --image 接图片路径、base64 或 data URL。生成后建议先查看图片确认质量再交付；返回的签名 URL 会过期，脚本已立即下载落盘，只交付本地文件。
适用场景：明确要求混元/腾讯云出图、需要垫图改图、走微信小程序生态使用激励额度、已配置腾讯云密钥并继续用混元的场景。
限制与注意：密钥等同账号权限，勿写入仓库、日志或对话；尺寸只能四选一，不支持的尺寸会被拒绝；422 为内容审核触发，重发同样内容必然失败，需改措辞；环境 ID 填错或凭据对应环境无资源包会导致失败；无资源包直接生成会产生费用。若只需零配置免费出图，可改用 freeimg skill（z-image-turbo）。