前言¶

在 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