灵造 Skill · 灵造AI 视频生成 AI Agent 能力包

让大模型用自然语言指挥中巨量-灵造AI（灵造智能体）批量出片：动画视频、数字人视频、混剪视频。底层走灵造智能体接口（开放平台 API），本能力包把接口说明、场景示例和命令行工具打成一个可直接交给 Agent 的包。

在线阅读（免登录）：https://ai-mix.chuhaibang.com/open-api/skill ｜完整接口文档：https://ai-mix.chuhaibang.com/open-api

你：用数字人做 3 条讲「秋季护肤」的短视频，每条 30 秒，配轻快点的音乐
AI：（自己选任务类型 → 查音色和素材分组 → 确认消耗积分 → 提交 → 轮询 → 给你成片链接）

不用先准备素材。 数字人形象、朗读音色、背景音乐、封面/字幕模板平台都已预置，画面还能用平台的热门素材分组或 AI 生成的动效卡——三类视频都能零素材起步，只有想用自己的素材时才需要先在网页端「素材管理」上传。

WorkBuddy 用户：技能市场一键安装

本包已上架 WorkBuddy 技能市场，不用下载 zip、也不用手动放目录：

左侧菜单点 「专家·技能·连接器」
切到顶部 「技能」 标签
右上角搜索框输入 「灵造AI」
在 SkillHub 分类下找到「灵造AI」，点卡片右上角 「+」 安装

WorkBuddy 技能市场安装灵造AI

重启 WorkBuddy 让 Skill 生效，聊天框直接说「用灵造做一条 30 秒的短视频」即可。首次使用会引导你填 API 密钥（在灵造AI「用户中心 → 开放平台」获取）。

其它 AI 工具：一句话安装

Claude Code / Codex / Cursor 等，把这段发给你的 AI 助手，它会自己下载、放到正确目录，并顺手把 MCP 也配好：

帮我安装「灵造AI 视频生成」技能包并配好 MCP：
1. 从 https://ai-mix.chuhaibang.com/skills/lingzao-video-skill.zip 下载并解压，
   把其中的 lingzao-video 目录放进技能目录：
   Claude Code / Claude 桌面端用 ~/.claude/skills/，其它工具用 ~/.agents/skills/。
2. 读一遍 lingzao-video/SKILL.md。
3. 按 SKILL.md 的「第零步」帮我配置灵造 MCP，我的密钥是 lz_你的密钥
   （服务地址 https://ai-mix.chuhaibang.com/mcp）。
4. 配好后调用 lingzao_get_account 验证连通，并告诉我你能用灵造帮我做什么。

目录结构

文件	作用
`SKILL.md`	工作流主文档：任务类型决策树、参数填法、硬性纪律
`AGENTS.md`	给读 AGENTS.md 约定的工具（Codex 等）的入口，内容指向 SKILL.md
`references/api.md`	接口速查：全部字段、取值、错误码、计费公式
`examples/`	5 个可直接照抄的场景示例 + 现成 payload JSON
`scripts/lingzao.py`	命令行工具（纯 Python 标准库，无需 pip install）
`_meta.json`	版本与来源元数据（打包时按 `SKILL.md` 的 `version` 自动生成）

本包和 MCP 是什么关系

MCP 给的是「能调什么」，本包给的是「怎么调才对」——选哪类任务、没素材时怎么办、时长只能取哪些档位、哪些字段传了会被静默忽略、以及提交前怎么把消耗算清楚。这些写不进 MCP 的工具描述（会占满上下文），却是出片质量和成本的关键。

两者配合使用效果最好。建议先装本包：装完它会按 SKILL.md 的「第零步」反过来带你把 MCP 配好。没配 MCP 也能用——包内自带零依赖命令行工具。

手动安装：放哪个目录

技能目录有两级作用域，项目级（只在当前项目生效）与用户级（所有项目可用）：

你的工具	用户级	项目级
Claude Code / Claude 桌面端	`~/.claude/skills/`	`.claude/skills/`
Codex / Gemini CLI / Cursor / Copilot 等	`~/.agents/skills/`	`.agents/skills/`

.agents/skills/ 是 Agent Skills 开放标准的跨工具通用约定路径——放在这里，支持该约定的客户端都能发现它，不必每个工具复制一份。

# 用户级（推荐，所有项目都能用）
mkdir -p ~/.agents/skills && cp -r lingzao-video ~/.agents/skills/

# Claude 系
mkdir -p ~/.claude/skills && cp -r lingzao-video ~/.claude/skills/

放好后工具会读 SKILL.md 的 frontmatter 自动判断何时启用，直接说需求即可。

目录名必须保持 lingzao-video——Agent Skills 规范要求目录名与 frontmatter 的 name 一致，改名会导致技能加载失败。

WorkBuddy

在技能面板里搜索添加；或用上面的「一句话安装」让 AI 代劳。

其它读 AGENTS.md 的工具

本包同时带了 AGENTS.md（内容指向 SKILL.md）。把目录放进项目根目录即可；如果工具只读项目根的 AGENTS.md，把本包 AGENTS.md 的内容追加进去，并把路径改成实际存放位置。

其它 Agent 框架（自定义接入）

只要 agent 能「读文件 + 执行 shell 命令」，本包就能用。三步接入：

把 lingzao-video 目录放到 agent 能读到的位置（工作目录/知识库/附件均可）。
在 agent 的系统提示词或知识库里加一句：

需要生成短视频时，先读 lingzao-video/SKILL.md 并按其流程执行；接口细节见 lingzao-video/references/api.md，示例见 lingzao-video/examples/。调用统一用 python lingzao-video/scripts/lingzao.py <子命令>。

把 API 密钥配到环境变量 LINGZAO_API_KEY（或在对话中直接告诉 agent）。

若你的工具有专属的 skill/插件规范（清单文件、注册接口等），把 SKILL.md 的正文作为指令内容、scripts/lingzao.py 作为可执行工具登记即可——本包不依赖任何特定框架。

不用 agent，直接自己调

scripts/lingzao.py 本身就是完整 CLI，可以直接用：

python scripts/lingzao.py voices                                  # 查音色
python scripts/lingzao.py create --type fluid --payload p.json    # 提交任务
python scripts/lingzao.py wait --task-id 123                      # 等结果

或参照 references/api.md 用任意语言直接发 HTTP 请求（只需带 X-Api-Key 头）。

命令行方式的准备（走 MCP 可跳过）

在灵造AI「用户中心 → 开放平台」点「获取 API 密钥」，拿到形如 lz_xxxx 的密钥。
设置两个环境变量（LINGZAO_API_BASE 用默认线上地址时可不设）：

# macOS / Linux
export LINGZAO_API_KEY="lz_你的密钥"
export LINGZAO_API_BASE="https://ai-mix.chuhaibang.com/api/v1/open"   # 可选

# Windows PowerShell
$env:LINGZAO_API_KEY="lz_你的密钥"

自检（同时验证密钥有效性与积分余额）：

python scripts/lingzao.py account

需要 Python 3.8+。脚本只用标准库，不装任何依赖。

命令速查

命令	作用
`account`	账户积分与套餐
`voices` / `bgm` / `outros` / `digital-humans`	可用音色 / 背景音乐 / 片尾 / 数字人
`clip-groups` / `clips --group-id N`	素材分组 / 分组内片段
`cover-templates`	标题封面模板
`create --type fluid\|digital-human\|video --payload x.json`	提交任务（会扣积分）
`status --task-id N` / `wait --task-id N`	查进度 / 轮询到完成
`tasks`	任务列表
`delete --task-id N --yes`	删除任务（不退积分）

注意

提交任务即按条计费，与网页端共用同一份余额。让 agent 提交前先算清消耗并与你确认条数和时长。
密钥等同账号密码，只放在你自己的机器/服务端；不要提交进公开仓库。