灵造 MCP 接入

MCP（Model Context Protocol）是 AI 工具连接外部能力的开放标准，可以理解成「AI 的 USB-C 接口」。配好之后不用写一行代码，直接对 AI 说「用数字人做 3 条讲秋季护肤的视频」，它会自己查音色、算积分、提交任务、取回成片链接。

WorkBuddy、Codex / ChatGPT、Claude Code、Claude 桌面端、Cursor 等主流 AI 客户端都支持 MCP。

先拿密钥：登录灵造AI →「用户中心 → 开放平台」→ 点「获取 API 密钥」，得到形如 lz_xxxx 的字符串，下面各处的 lz_你的密钥 都换成它。那个页面还能按客户端直接复制配置指令，比手抄本文更快。

服务地址与鉴权

地址：https://ai-mix.chuhaibang.com/mcp（Streamable HTTP）

最省事的配置办法：把下面这段复制给你正在用的 AI 助手，它会帮你把配置写好并验证连通—— 你不需要知道配置文件在哪：

帮我在本机配置灵造AI 的 MCP 服务，服务地址 https://ai-mix.chuhaibang.com/mcp，
鉴权请求头 Authorization: Bearer lz_我的密钥。
按我当前使用的客户端选择正确的配置位置写入，写完告诉我要不要重启，
然后调用 lingzao_get_account 验证是否连通。

按客户端配置

客户端	配置方式
WorkBuddy	连接器管理页 → 右上角「自定义连接器」→ 按下方 JSON 新增一项 → 在卡片上点「信任」才会生效
Codex / ChatGPT	写进 `~/.codex/config.toml`（格式见下方 TOML，键名是 `http_headers`，不是 `headers`）。完成后新开会话
Claude Code	`claude mcp add --transport http lingzao https://ai-mix.chuhaibang.com/mcp --header "Authorization: Bearer lz_你的密钥"`（注意 header 用冒号不是等号；会话里 `/mcp` 看状态）
Cursor	写进 `~/.cursor/mcp.json`（或项目内 `.cursor/mcp.json`），格式见下方 JSON
Claude 桌面端	Settings → Connectors → Add custom connector，URL 填 `https://ai-mix.chuhaibang.com/mcp/lz_你的密钥`（该客户端不便传自定义头，用路径带密钥的形式）

通用 JSON 格式（Cursor / 多数客户端）：

{
  "mcpServers": {
    "lingzao": {
      "url": "https://ai-mix.chuhaibang.com/mcp",
      "headers": { "Authorization": "Bearer lz_你的密钥" }
    }
  }
}

Codex / ChatGPT 的 ~/.codex/config.toml 用的是 TOML，格式不一样：

[mcp_servers.lingzao]
url = "https://ai-mix.chuhaibang.com/mcp"
http_headers = { Authorization = "Bearer lz_你的密钥" }

键名必须是 http_headers。 Codex 的 [mcp_servers.*] 只认 http_headers、env_http_headers、bearer_token_env_var 三个键，写成别的（比如照抄 JSON 里的 headers）会被静默忽略——请求发出去不带鉴权头，服务端只能回「缺少 API 密钥」，看起来像是密钥错了，实际是配置没生效。不想让密钥明文留在配置文件里，可以改用环境变量：删掉 http_headers 那行，换成 bearer_token_env_var = "LINGZAO_API_KEY"，再把密钥设进同名环境变量（注意这里填的是变量名，不是密钥本身）。

密钥也可以用 X-Api-Key 头传。若客户端不支持自定义请求头，可退而把密钥写进路径： https://ai-mix.chuhaibang.com/mcp/lz_你的密钥 —— 但密钥会留在客户端配置与日志里，有泄露风险，可随时在用户中心重置。

怎么确认配好了：对 AI 说一句「查看我的灵造账户积分余额」，能报出积分数字就算接通。

连上后可用 5 个工具：

工具	作用
`lingzao_get_account`	查可用积分与存储配额
`lingzao_list_resources`	查音色 / 数字人 / 背景音乐 / 片尾 / 素材分组 / 模板的 ID
`lingzao_estimate_cost`	预估消耗，不扣费——提交前先算
`lingzao_create_video`	创建任务（动画 / 数字人 / 混剪），会扣积分
`lingzao_get_task`	查进度；完成后连同成片直链、封面、发布标题、发布正文、分发关键词、各平台推荐 @大V 一起返回

之后用自然语言下指令即可。AI 会自己查形象和音色、预估积分、向你确认后再提交，然后轮询到成片链接。

常用玩法（直接照抄，把 `{}` 换成你的内容）

你想做什么	对 AI 说
最快出一条片（零素材）	用灵造做 1 条 30 秒的动画视频，讲 `{主题}`，帮我配个合适的音色
真人形象口播	用灵造的数字人做 1 条 30 秒视频讲 `{主题}`，开头 10 秒露脸，后面配平台热门素材
完全没有素材的混剪	用灵造做 1 条混剪，主题 `{主题}`，画面用平台的热门素材分组，加字幕和背景音乐
批量测试不同角度	用灵造做 5 条 30 秒动画视频，都讲 `{主题}` 但切入角度不同，先告诉我要花多少积分
用我自己的素材	用灵造做 3 条混剪，用我素材分组里的「`{分组名}`」，主题 `{主题}`
先看看要花多少钱	用灵造做 10 条 60 秒数字人视频要多少积分？我现在余额够吗？

想让 AI 更懂怎么用好这些工具（选任务类型、挑素材来源、控制成本），再装一个灵造 Skill 能力包——MCP 给的是「能调什么」， Skill 给的是「怎么调才对」。

生成视频按条计费。工具描述里要求 AI 提交前先用 lingzao_estimate_cost 算出消耗并向你确认， quantity 默认为 1——条数和花多少由你说了算，不会替你做主。

配合灵造 Skill 用效果更好

MCP 解决的是「AI 能不能调灵造」，灵造 Skill 能力包解决的是「AI 知不知道怎么调才对」——选哪类任务、没素材时画面从哪来、时长只能取哪些档位、提交前怎么把消耗算清楚。这些内容写进 MCP 的工具描述会占满上下文，却决定出片质量和成本。

Skill 支持一句话安装，装完它还会反过来帮你把 MCP 配好。

常见问题

Q：用 MCP 生成视频要花钱吗？ 消耗账号里的积分，与网页端同一份余额、同样的计价公式，不额外收费。工具里专门提供了 lingzao_estimate_cost：先算出这次要花多少、余额够不够，且不产生任何消耗。工具描述要求 AI 拿到结果后先告诉你、得到确认再提交，生成条数默认为 1。

Q：我的客户端不支持自定义请求头怎么办？ 把密钥写进地址：https://ai-mix.chuhaibang.com/mcp/lz_你的密钥。注意密钥会留在客户端配置与日志里，可随时在用户中心重置。

Q：配好了但工具调不出来？ 客户端里的实际注册名通常带前缀（如 mcp__lingzao__lingzao_get_account），部分客户端还是延迟加载——先按 lingzao 搜一次工具列表再判断。

Q：成片能留多久？ API 与 MCP 创建的任务，成品默认保留 1 天，拿到链接尽快下载。需要长期留存可在创建时让 AI 传 keep_forever: true（会持续占用存储配额）。