前言¶
在對話裏直接出圖，常見做法是單獨寫腳本調開放平臺，再把鏈接貼回聊天。每次換尺寸、開關水印都要改參數或查文檔，和 Agent 的工作流也容易脫節。下面介紹 SkillHub 上的社區 Skill「智譜glm-image生圖」：裝好並配置智譜 API Key 後，由 Agent 按統一工具接口調用 GLM-Image，支持多種畫幅比例與水印開關。
這是什麼¶
「智譜glm-image生圖」是遵循通用 SKILL.md 格式的 Agent Skill，座標爲 @user_c5e5dc86/zhipu-image，當前版本 1.0.0，來源爲 community，分類爲 design-media。Skill 包內說明其面向 OpenClaw 生態（skill.json 要求 OpenClaw >= 4.10.0、Python >= 3.8），通過智譜開放平臺的 GLM-Image 模型完成文本到圖像生成。發佈者在 SkillHub 爲 user_c5e5dc86，技能作者署名爲 skill大神。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_c5e5dc86/zhipu-image
- API 座標頁：https://api.skillhub.cn/user_c5e5dc86/zhipu-image
核心功能¶
根據 Skill 說明與 skill.json，已覈實能力包括：
- 調用模型
glm-image，默認畫質爲hd（實現中寫死爲 GLM-Image 支持的 hd 質量）。 - 工具名
zhipu_generate_image，必填參數prompt（文本描述）；可選size、watermark。 - 七種預設尺寸：1280x1280、1568×1056、1056×1568、1472×1088、1088×1472、1728×960、960×1728；默認 1280x1280。
- 水印默認開啓（
watermark默認 true）；關閉水印需在智譜平臺先簽署免責聲明（Skill 文檔中的說明）。 - 成功調用後返回圖片鏈接；文檔註明臨時鏈接有效期約 30 天，需自行轉存。
- 標籤
requires_api_key=true：須在技能配置或環境變量中提供智譜 API Key。
HTTP 調用端點爲 https://open.bigmodel.cn/api/paas/v4/images/generations（見技能包內 generate_image.py）。
安裝與啓用¶
先做 CLI 檢查；未安裝時按 SkillHub 官方安裝文檔執行完整安裝或僅 CLI：
command -v skillhub && skillhub --version
# 完整安裝（CLI + 默認 Skill，推薦）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 僅安裝 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。SkillHub 頁面給出的安裝提示爲：依據 https://skillhub.cn/install/skillhub.md，安裝 @user_c5e5dc86/zhipu-image。命令行等價示例：
skillhub install zhipu-image --namespace user_c5e5dc86 --dir ~/.cursor/skills/
Cursor 常用路徑爲 ~/.cursor/skills/；Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下 .agents/skills/（路徑來自 SkillHub 安裝文檔，按你實際使用的客戶端選擇）。
配置 API Key 有兩種方式（技能包文檔）：
- 在技能配置中填寫字段
api_key（skill.json中required: true）。 - 環境變量
ZHIPU_IMAGE_API_KEY（generate_image.py與USAGE_EXAMPLE.md）。
Key 獲取地址：https://bigmodel.cn/usercenter/proj-mgmt/apikeys ；需先在 https://bigmodel.cn/ 註冊並保證賬戶有足夠調用額度。
若技能依賴 Python 包，可在技能目錄內按 requirements.txt 安裝依賴（包內包含 requests 等）。
典型用法¶
在支持 OpenClaw 工具的對話裏¶
Skill 文檔中的斜槓命令形式：
/zhipu_generate_image 一隻可愛的小貓咪，坐在陽光明媚的窗臺上，背景是藍天白雲
自定義尺寸（注意文檔中使用 × 或 x 書寫寬高）：
/zhipu_generate_image 賽博朋克風格的城市夜景，霓虹燈閃爍，下雨的街道 size=1728×960
關閉水印：
/zhipu_generate_image 水彩風格的風景畫，山川河流，日出 watermark=false
README 中還提供封裝命令示例（需技能安裝後的命令是否在 PATH 取決於宿主環境）：
zhipu_generate_image "一隻可愛的小貓咪，坐在陽光明媚的窗臺上"
zhipu_generate_image "賽博朋克風格的城市夜景" size=1728×960
zhipu_generate_image "水彩風格的風景畫" watermark=false
直接運行技能包腳本¶
在技能目錄下可用 generate_image.py 做本地驗證（需已設置 ZHIPU_IMAGE_API_KEY）：
python generate_image.py "一隻可愛的橘貓，躺在陽光下的地毯上，毛茸茸的，治癒系風格"
JSON 參數方式：
python generate_image.py '{"prompt": "未來科技感的人工智能機器人，銀白色金屬質感，藍色眼睛，背景是數據中心", "size": "1568×1056", "watermark": true}'
成功時返回 JSON，字段包含 success、image_url、prompt、size 等（見 USAGE_EXAMPLE.md 示例結構）。
適用場景與注意¶
適合需要在 OpenClaw 或兼容 SKILL 工具的 Agent 裏快速接入智譜文生圖、且希望統一用 prompt / size / watermark 三參控制的開發者。SkillHub 側統計（抓取時）：評分 100000，下載 1244，安裝 3。
使用時注意：
- 內容需符合智譜開放平臺內容安全政策；違規 prompt 會導致失敗。
- 尺寸需滿足文檔要求：長寬爲 32 的整數倍，像素總數不超過 2^22。
- 費用按智譜開放平臺計費標準收取，與本 Skill 無關。
- 本 Skill 爲社區發佈（community），與智譜官方無直接維護關係；問題排查可先查 API Key、額度與 prompt，再結合返回錯誤信息。
結尾¶
「智譜glm-image生圖」把 GLM-Image 封裝成 Agent 可調用的 zhipu_generate_image，配置 Key 後即可在對話或腳本里生成多尺寸圖片並控制水印。需要安裝或查看說明時，以 SkillHub 官方頁爲準：https://www.skillhub.cn/skills/user_c5e5dc86/zhipu-image
