前言¶

做广告素材、运营海报或印刷品的同学，多半遇到过这样的场景：需求方一句“要一张 16:9 的 4K 图”，剩下的全靠设计师在页面里一点点调，出图慢、批量难、比例和分辨率来回切换还容易出错。

下面介绍的 Skill「AI Image Gen」（坐标 @clawhub_qiujiahong/ai-image-gen）就是为这个问题准备的：它把图像生成封装成一个标准 SKILL.md 技能，Agent 可以直接执行脚本，把提示词变成指定比例和分辨率的图片，不用再打开 Web 页面手动操作。

这是什么¶

AI Image Gen 是一个基于 SKILL.md 格式的图像生成技能，由 qiujiahong（Nick Qiu）发布在 ClawHub，版本 v1.1.0，MIT-0 协议。它解决的是“从一句话到一张成图”的自动化问题：Agent 收到画图需求后，按流程选定比例和分辨率，调用脚本生成图片并展示。

工作方式不是调用云端 UI，而是通过脚本请求 Gemini Flash Image API，因此提示词和输出路径都可以程序化控制，适合放进自动化流程。

核心功能¶

1、文生图：根据提示词生成图片。
2、图+文生图：在已有图片基础上叠加文本描述进行生成。
3、风格转换：把已有图片转成其他风格。

支持的比例（10 种）：1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9。

支持的分辨率：标准、2K、4K。分辨率与比例通过模型 ID 绑定，例如 gemini-3.1-flash-image-2k-16x9 表示 2K 分辨率、16:9 横屏。

官方页面提供了完整的模型 ID 列表：标准分辨率覆盖 10 种比例，2K 分辨率同样覆盖 10 种比例，4K 分辨率列表里包含 9 种比例（没有 21:9 对应的 4K 模型）。

安装与启用¶

ClawHub 的安装命令如下，在 OpenClaw 环境中执行：

$ openclaw skills install @qiujiahong/ai-image-gen

脚本通过环境变量获取 API 配置，共两项：

export IMAGE_GEN_API_KEY="your-api-key"
export IMAGE_GEN_BASE_URL="https://code.newcli.com/gemini"

• IMAGE_GEN_API_KEY：API 密钥，必填。
• IMAGE_GEN_BASE_URL：API 基础地址，默认 https://code.newcli.com/gemini。

脚本为 scripts/generate_image.py，需要 Python 3 环境运行。官方资料未提到 Cursor、Codex CLI、Claude Code 的接入方式，这里不展开。

典型用法¶

生成图片的完整命令：

python3 scripts/generate_image.py "你的提示词" --model gemini-3.1-flash-image-2k-16x9 --output output.png

参数说明：

• prompt（必填）：图片描述提示词。
• --model / -m：模型名称，默认 gemini-3.1-flash-image-2k-16x9。
• --output / -o：输出文件路径，默认当前目录下的 generated_image.png。

官方给出的示例，生成一张中国风后羿射日图：

python3 scripts/generate_image.py \
"一位英勇的古代射手后羿站在险峻的高山之巅，身披金色战甲，肌肉紧绷，拉开巨大的神弓，一支燃烧着神圣光芒的箭矢对准天空中炽热的太阳。天空中有多个太阳同时燃烧，火焰倾泻而下。背景是翻滚的云海和龟裂的大地，远山在热浪中扭曲。中国传统工笔重彩风格，水墨与金箔点缀，色彩以深红、金色、墨黑、靛蓝为主，画面气势磅礴，具有敦煌壁画的厚重感。16:9 宽幅构图。" \
--model gemini-3.1-flash-image-2k-16x9 \
--output houyi.png

官方建议的提示词技巧：写清楚主体、场景、光线、风格、色调；给出风格参考（水彩、油画、赛博朋克、吉卜力、写实摄影、中国工笔等）；说明构图（视角、景深、焦点）；指定主色调和配色方案。

Agent 侧的工作流程是：理解需求 → 选择模型（默认 2K-16:9）→ 优化提示词 → 执行脚本 → 展示结果。

适用场景与注意¶

适合需要批量、可复现出图的场景：广告海报初稿、社媒配图、印刷素材的快速出样。由于输出路径和模型都由命令行指定，可以把生成过程串进流水线，按不同比例和分辨率批量跑。

几点注意：

1、需要自备 Gemini Flash Image 的 API 密钥，IMAGE_GEN_API_KEY 未配置时脚本无法工作。
2、4K 模型列表中没有 21:9 超宽屏选项，需要 21:9 时只能选标准或 2K 分辨率。
3、模型 ID 较长且与比例、分辨率一一对应，选错模型会拿到非预期的比例或分辨率。
4、MIT-0 协议允许商用，但图片的实际商用授权取决于生成服务方（Gemini Flash Image API）的条款，使用前建议确认。
5、官方资料中没有批量生成、风格转换脚本参数的详细说明，如果需要大批量或批量风格转换，需要自行封装循环调用。

小结¶

AI Image Gen 的价值在于把“出图”这一步变成 Agent 可直接执行的标准技能：一个脚本、两个环境变量、一张模型 ID 表，就能覆盖从 1:1 头像到 16:9 壁纸的生成需求，并支持到 4K 分辨率。

官方地址：https://api.skillhub.cn/zcwl/ai-image-gen
上游仓库：https://clawhub.ai/qiujiahong/ai-image-gen