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

让大模型用自然语言指挥灵造AI（中巨量）开放平台批量出片：动画视频、数字人视频、混剪视频。

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

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

目录结构

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

准备（所有工具通用）

在灵造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+。脚本只用标准库，不装任何依赖。

按工具接入

Claude Code / Claude 桌面端

把整个 lingzao-video 目录放进 skills 目录：

# Claude Code
cp -r lingzao-video ~/.claude/skills/

# 项目级（只在当前项目生效）
cp -r lingzao-video .claude/skills/

Claude 会根据 SKILL.md 的 frontmatter 自动判断何时启用，直接说需求即可。

OpenAI Codex / 其它读 AGENTS.md 的工具

把目录放到项目里（或工作目录），工具会读取 AGENTS.md 并按其指引加载 SKILL.md：

cp -r lingzao-video ./            # 放到项目根目录
# 或把 AGENTS.md 的内容并入项目已有的 AGENTS.md

如果工具只读项目根目录的 AGENTS.md，把本包 AGENTS.md 的内容追加进去，并把路径改成实际存放位置。

WorkBuddy 及其它支持执行命令的 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 头）。

命令速查

命令	作用
`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 提交前先确认条数和时长。
密钥等同账号密码，只放在你自己的机器/服务端；不要提交进公开仓库。
图文创作暂不通过 API 开放，只提供视频能力。