前言¶
做廣告素材、運營海報或印刷品的同學，多半遇到過這樣的場景：需求方一句“要一張 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
