前言¶
在 Cursor、Claude Code 等环境里做封面、海报或短视频时，常见做法是单独打开智谱开放平台网页，或自己写脚本调 CogView、CogVideoX。对话和生成工具被拆成两步，提示词也要重复整理。
下面介绍 SkillHub 上的社区 Skill「智谱免费文生图文生视频」（坐标 @user_9aa92135/bigmodel-image-video，版本 1.0.0）。它把 BigModel 文生图、文生视频能力封装成 Agent 可读的 SKILL 说明与脚本，让模型在用户要「做图」「做视频」「设计封面」时主动走同一套流程。
这是什么¶
一句话定位：通过智谱 BigModel（CogView / CogVideoX）API，按文本提示生成图片或视频内容的 Agent Skill。
- 来源：SkillHub 社区（
community），分类design-media，发布者user_9aa92135。 - 解决的问题：把「生成图片 / 制作视频 / AI 绘画 / 创建封面 / 设计海报」等视觉需求，收敛到 Skill 触发条件与安装后的
SKILL.md指引里；即使用户没说「生成」二字，只要是在创建、设计视觉内容（小说封面、产品图、宣传图、短视频等），Skill 简介也要求 Agent 主动启用。
SkillHub 页面标注需配置 API Key（requires_api_key=true）。SkillHub 统计（以抓取资料为准）：评分 100000，下载 6957，安装 113。
核心功能¶
以下能力与官方简介及同版本 Skill 文档一致，均围绕 BigModel 接口：
- 文生图：调用 CogView 系列模型，按 prompt 生成图片，可选尺寸、画质等参数。
- 文生视频：调用 CogVideoX 系列模型，按 prompt 生成视频（文档说明支持含 AI 音频的视频生成流程）。
- 批量生成：支持一次提交多条提示词批量出图，并可控制并发。
- 脚本与库两种入口：安装包内提供
scripts/generate.py命令行，以及lib/image_video.py中的generate_image、batch_generate_images、generate_video、wait_for_video等函数（视频为异步任务，需wait_for_video轮询结果）。
文档中列出的图片模型包括 cogview-3-flash、cogview-4-250304、cogview-4；视频模型包括 cogvideox-flash、cogvideox-2、cogvideox-3。常用输出尺寸示例：1024x1024、1024x1792、1792x1024。
安装与启用¶
通过 SkillHub 安装（官方推荐）¶
SkillHub 技能页要求按 SkillHub 安装说明 安装本 Skill，坐标为 @user_9aa92135/bigmodel-image-video。
1、确认本机已有 skillhub CLI（未安装时可按安装文档执行官方安装脚本）。
command -v skillhub && skillhub --version
2、安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install user_9aa92135/bigmodel-image-video --dir <你的 skills 目录>
各客户端常见路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后重启或刷新 Agent，使其加载新 Skill。也可将安装说明发给 AI，让其按 https://skillhub.cn/install/skillhub.md 完成安装。
配置 API Key¶
Skill 依赖智谱 BigModel 开放平台密钥。文档要求设置环境变量 BIGMODEL_API_KEY（在 智谱 AI BigModel 开放平台 申请）。
当前 shell 临时生效：
export BIGMODEL_API_KEY=your_api_key_here
写入 shell 配置后长期生效（示例为 zsh；bash 用户可改为 ~/.bashrc）：
echo 'export BIGMODEL_API_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc
未设置时，脚本通常会提示需要 BIGMODEL_API_KEY。
典型用法¶
安装完成后，进入该 Skill 所在目录（或让 Agent 按 SKILL.md 操作）。下面示例来自 v1.0.0 Skill 文档中的可复现命令。
命令行脚本¶
生成单张图片：
python scripts/generate.py "一只可爱的橘猫"
生成视频：
python scripts/generate.py "海边日落" --video
空格分隔多条提示词做批量出图：
python scripts/generate.py "日出 日落 星空 彩虹" --batch
查看参数说明：
python scripts/generate.py --help
竖版封面可指定尺寸，例如：
python scripts/generate.py "中国武侠小说封面，水墨画风格，远山如黛，云雾缭绕" --size 1024x1792
短视频可指定时长（示例为 5 秒）：
python scripts/generate.py "一朵花在阳光下缓缓开放" --video --duration 5
Python 调用¶
在 Skill 根目录下，将 lib 加入路径后调用封装函数：
import sys
sys.path.insert(0, "lib")
from image_video import generate_image, batch_generate_images, generate_video, wait_for_video
result = generate_image(
prompt="描述内容",
model="cogview-3-flash",
quality="standard",
size="1024x1024",
)
url = result["data"][0]["url"]
video = generate_video(prompt="描述内容", duration=5)
final = wait_for_video(video["id"])
video_url = final["video_result"][0]["url"]
更完整的参数表、Prompt 写法与 FAQ 见安装后的 SKILL.md、README.md 及 lib/image_video.py 内文档。
适用场景与注意¶
适合谁
- 已在用 Cursor / Claude Code 等 Agent，希望对话里直接出封面、海报、社媒配图或短视频草稿的开发者或创作者。
- 愿意使用智谱 BigModel API，并能自行管理
BIGMODEL_API_KEY与调用配额的用户。
使用上注意
- 密钥与费用：
requires_api_key=true，所有生成走官方 API，需遵守智谱平台计费与限流规则；勿把 Key 提交进仓库。 - 社区来源：Skill 为社区发布，安装前可在 SkillHub 页面查看版本与说明；生产环境建议先小流量验证效果与稳定性。
- 路径与客户端：
skillhub install的--dir必须对应当前 Agent；不同客户端 skills 目录不同，装错目录会导致 Skill 不生效。 - 视频异步：视频生成需等待任务完成；文档建议失败时简化 prompt、换用 flash 模型或检查网络。
- 质量与速度：文档建议先用
cogview-3-flash/cogvideox-flash试效果，定稿再用cogview-4、cogvideox-3及--quality hd。
结尾¶
「智谱免费文生图文生视频」把 CogView、CogVideoX 的常用出图、出片流程写进 Agent Skill：安装到对应 skills 目录、配置 BIGMODEL_API_KEY 后，即可用脚本或 Python 库在对话任务里生成视觉素材。
- SkillHub 页面：https://www.skillhub.cn/skills/user_9aa92135/bigmodel-image-video
- 官方坐标/API 入口：https://api.skillhub.cn/user_9aa92135/bigmodel-image-video
- 安装说明：https://skillhub.cn/install/skillhub.md
