前言¶
在 Cursor、Claude Code 等环境里，模型本身往往不能直接产出可下载的图片或短视频。常见做法是自行查阅智谱开放平台文档、拼装 HTTP 请求、处理异步任务与本地保存——步骤分散，也不利于 Agent 按统一规范反复调用。
下面介绍 SkillHub 上的「智谱图片视频生成」（包名 glm-image-gen-pro）。它把智谱图片与视频相关能力封装成标准 SKILL.md 技能包，由 Agent 读取说明后驱动内置 CLI 脚本完成生成。
这是什么¶
「智谱图片视频生成」是 SkillHub 社区技能，坐标为 @user_3cce866c/glm-image-gen-pro，官方入口为：
https://api.skillhub.cn/user_3cce866c/glm-image-gen-pro
在 SkillHub 分类中属于 design-media（设计多媒体）。线索数据中的社区指标为：评分 99838、下载 618 次（截至撰稿时由任务线索提供）。
SkillHub 平台对包内文档与脚本的评测摘要指出：该技能基于智谱 AI 官方 API（文档与调用指向国内域名 open.bigmodel.cn），通过 scripts/glm_image_cli.py 与 scripts/glm_video_cli.py 分别覆盖文生图与视频生成（含本地图片转视频的 base64 直传路径），并配套中文 README.md / SKILL.md、定价说明与 FAQ。
核心功能¶
以下能力来自 SkillHub 公开评测接口对包内 SKILL.md 与脚本逻辑的归纳（skillhub skill evaluation glm-image-gen-pro --namespace user_3cce866c），而非臆测：
- 文生图：支持多模型选型，评测中明确提到
glm-image、cogview-4、cogview-3-flash；支持尺寸校验（如glm-image要求宽高在 1024–2048px 且为 32 的倍数）、画质（hd/standard）、水印开关，以及可选user_id用于内容侧标识。 - 视频生成：支持文生视频与图生视频；图生视频可将本地图片以 base64 提交，无需先上传到公网。视频侧为异步任务，脚本内含轮询与下载逻辑；评测提到视频模型包含 CogVideoX-2，默认最长等待约 600 秒、轮询间隔约 30 秒，成片常见等待约 60–90 秒。
- 密钥与配置：通过环境变量或配置文件加载智谱 API Key（评测中统一以
ZHIPU_API_KEY及load_zhipu_key逻辑描述）；缺少密钥、限流、内容审核、超时等场景有结构化错误码（如MISSING_API_KEY、RATE_LIMIT、CONTENT_FILTER、TIMEOUT）。 - 文档与合规：
SKILL.md含提示词技巧、参数表、错误处理与去水印相关说明（评测提及需按开放平台「个人中心 → 安全管理 → 去水印管理」流程处理无水印能力）。安全扫描结论为双实验室交叉验证、无 P0/P1 级风险（同样来自上述评测接口）。
安装与启用¶
通过对话让 Agent 安装¶
SkillHub 通用安装说明见 skillhub.cn/install/skillhub.md。可将下面提示交给当前 Agent（安装时需把 --dir 指向当前客户端的 skills 目录）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3cce866c/glm-image-gen-pro`。
安装目录使用 Cursor 的 ~/.cursor/skills/（或我当前 Agent 对应的 skills 路径）。
使用 SkillHub CLI¶
若本机已安装 skillhub，可先确认 CLI 可用，再执行安装：
command -v skillhub && skillhub --version
安装到 Cursor 默认技能目录的示例：
skillhub install glm-image-gen-pro --namespace user_3cce866c --dir ~/.cursor/skills/
Claude Code 常用 ~/.claude/skills/；Codex 常用 ~/.codex/skills/ 或项目下 .agents/skills/。路径差异以 安装文档 第四节为准。
配置 API Key¶
评测报告描述：密钥可通过环境变量或配置文件注入，变量名为 ZHIPU_API_KEY。在智谱开放平台创建 Key 后，至少在运行生成脚本的环境中导出该变量，或由技能包文档说明的配置文件路径写入（具体字段以安装后的 SKILL.md 为准）。
export ZHIPU_API_KEY="你的智谱开放平台 API Key"
安装状态说明（撰稿时实测）¶
2026-10-21 核对时：skillhub install 能解析到 @user_3cce866c/glm-image-gen-pro，但下载地址 https://api.skillhub.cn/api/v1/download?slug=glm-image-gen-pro&namespace=user_3cce866c 返回 HTTP 404；skillhub.cn 对应技能页显示「Skill 未找到」。若你遇到相同情况，需在 SkillHub 上确认版本是否恢复，或联系发布者后再装。
典型用法¶
安装成功并配置 ZHIPU_API_KEY 后，Agent 应按包内 SKILL.md 的流程调用脚本，而不是自行「画图」或绕过 API。
文生图¶
评测与包结构均指向 scripts/glm_image_cli.py。CLI 设计包含 --prompt / -p、--size / -s、--quality / -q、--no-watermark、--user-id、--save 等参数；图片请求侧有约 120 秒超时控制。具体命令行示例、默认可选尺寸枚举以安装后的 SKILL.md 为准。
图生视频 / 文生视频¶
视频路径由 scripts/glm_video_cli.py 负责：创建异步任务后轮询状态，完成后下载到本地。评测指出视频生成依赖 zhipuai SDK，若文档未写清依赖，安装后应先按 SKILL.md 或 README.md 补齐 Python 依赖再执行。
在对话中的触发方式¶
向 Agent 描述视觉需求即可，例如：「用智谱生成一张 16:9 的产品概念图」「把这张本地 PNG 做成 5 秒宣传短视频」。技能包应在命中生图、生视频意图时主动读取 SKILL.md 并执行对应脚本，将返回的 URL 或本地文件路径呈现给你。
适用场景与注意¶
适合谁
- 已使用智谱开放平台、希望在 Agent 会话里统一完成海报、插画、短视频素材的同学。
- 需要国内可直连的
open.bigmodel.cn端点，并希望脚本层封装轮询、下载与错误码的团队。
限制与坑
- 安装可用性：撰稿时社区包下载 404，网页入口不可用；动手前请先验证能否成功
skillhub install。 - 耗时：HD 文生图评测侧提到约 20 秒量级；视频常见 1–2 分钟等待，需容忍异步轮询。
- 费用与模型：
SKILL.md内含模型与价格对照表，按次计费；选型前先看文档，避免误用高价模型。 - 内容审核：触发
CONTENT_FILTER时应调整提示词，而非反复重试相同违规描述。 - 无批量与弱重试：评测指出缺少批量出图与自动重试，网络抖动时可能需要人工重跑。
- 包内重复路径：评测提到
scripts/与glm/scripts/可能存在重复文件，以SKILL.md指定的入口为准。
结尾¶
「智谱图片视频生成」把智谱文生图、图生视频和密钥配置收敛到一个 SkillHub 技能包，适合想把多媒体产出放进 Agent 工作流、又不想每次手写 API 的开发者。社区坐标为 @user_3cce866c/glm-image-gen-pro，官方地址：
https://api.skillhub.cn/user_3cce866c/glm-image-gen-pro
安装与客户端路径说明亦可对照 SkillHub 安装文档。
