前言¶

在 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 接口：

1. 文生图：调用 CogView 系列模型，按 prompt 生成图片，可选尺寸、画质等参数。
2. 文生视频：调用 CogVideoX 系列模型，按 prompt 生成视频（文档说明支持含 AI 音频的视频生成流程）。
3. 批量生成：支持一次提交多条提示词批量出图，并可控制并发。
4. 脚本与库两种入口：安装包内提供 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 与调用配额的用户。

使用上注意

1. 密钥与费用：requires_api_key=true，所有生成走官方 API，需遵守智谱平台计费与限流规则；勿把 Key 提交进仓库。
2. 社区来源：Skill 为社区发布，安装前可在 SkillHub 页面查看版本与说明；生产环境建议先小流量验证效果与稳定性。
3. 路径与客户端：skillhub install 的 --dir 必须对应当前 Agent；不同客户端 skills 目录不同，装错目录会导致 Skill 不生效。
4. 视频异步：视频生成需等待任务完成；文档建议失败时简化 prompt、换用 flash 模型或检查网络。
5. 质量与速度：文档建议先用 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