关于 levea-mcp-server
levea-mcp-server 将自然语言视频编辑请求交给云端视频制作后端,由 AI Agent 规划、执行并导出成片,适用于通过 MCP 客户端处理视频的创作者。支持在执行前要求人工审批计划。
主要功能
- 01自然语言驱动多步骤剪辑
- 02生成短视频、字幕并调整画幅
- 03绿幕抠像与 AI 背景移除
- 04音频清理、配音与音乐混音
- 05管理项目、素材和字幕模板
- 06支持流式进度与异步任务
适用场景
- 01将长播客剪成带字幕的竖屏短片
- 02为不同社交平台导出多种画幅
- 03替换背景并跟踪居中人物
- 04审批剪辑计划后再执行
MCP 相关
作为 MCP 服务向 Claude、Cursor、Cline 等客户端提供视频编辑及项目、素材和模板管理工具。也可通过托管的 Streamable HTTP 端点连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.livecore.ai/api/v1/misc/mcpclaude mcp add --transport http brajendrak00068-levea https://api.livecore.ai/api/v1/misc/mcp{"mcpServers":{"brajendrak00068-levea":{"type":"http","url":"https://api.livecore.ai/api/v1/misc/mcp"}}}在 Cursor 中打开{"servers":{"brajendrak00068-levea":{"type":"http","url":"https://api.livecore.ai/api/v1/misc/mcp"}}}在 VS Code 中打开{"mcpServers":{"brajendrak00068-levea":{"type":"http","url":"https://api.livecore.ai/api/v1/misc/mcp"}}}{"mcpServers":{"brajendrak00068-levea":{"serverUrl":"https://api.livecore.ai/api/v1/misc/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://api.livecore.ai/api/v1/misc/mcp需要授权工具
25| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| scene | object | 否 | 用于继续编辑的可选现有场景/时间线状态(高级)。 |
| assets | array | 否 | 可选的资源描述符。每项格式:{ id?, type: "video"|"image"|"audio", url|src, mimeType?, duration? }。 |
| prompt | string | 是 | 所需编辑内容或创意简报的自然语言描述。后端规划器会将其拆解为规范操作(热门短片、字幕、重新构图、导出,…)。请原样发送用户意图——不要预先拆解为多个调用。 |
| brandId | string | 否 | 本次调用要应用的可选品牌配置 ID(配色、字体、徽标、声音、gradeBias)。通过 list_brand_kits 查询 ID。会覆盖项目默认品牌。 |
| core_only | boolean | 否 | 如果为 true,响应仅包含渲染必需的场景字段(不含调试元数据)。 |
| video_url | string | 否 | 可选的源视频 URL。未提供场景时,会自动将其设为起始图层。 |
| editedPlan | object | 否 | 可选的预编辑计划对象,由先前返回 awaiting_approval 的响应提供。 |
| project_id | string | 否 | 用于跟踪/延续的可选项目 ID。 |
| flaggedIssues | array | 否 | 本次运行中用户标记的具体问题列表(可选,例如 ["caption #3 misspelled"])。 |
| workingMemory | object | 否 | 先前调用返回的工作记忆快照(通常由返回 awaiting_approval 的调用返回)。重新发送即可恢复该运行。 |
| attachedImages | array | 否 | Agent 在规划时应参考的 Base64 编码参考图像(可选)。 |
| projectBrandId | string | 否 | 项目的可选默认品牌。会持久保存;单次调用的 brandId 优先。 |
| captionTemplateMode | enum | 否 | 如何应用 captionTemplatePreset。add | recreate | style | translate | clear | remove_fillers |
| requirePlanApproval | boolean | 否 | 如果为 true,Agent 会在规划后停止,并返回 { status: "awaiting_approval", workingMemory, plan },且不进行任何修改。通过重新调用并附上返回的 workingMemory 和批准提示词("yes", "approve", "do it")来继续。 |
| captionTemplatePreset | string | 否 | 重新生成字幕时应用的可选字幕模板 slug。可选值为 41 个内置模板之一(hormozi、mrbeast、viral-pop、minimal-pro、karaoke、neon-pop、typewriter、pop-wave、subtitle-bar、creator-box、…),或 list_caption_templates 返回的用户保存模板 ID。 |
详细介绍
Levea MCP 服务
一款自主式 Agent 视频编辑器。 发来一句话,即可获得成片。无需时间线、关键帧或插件链。开源 MCP 客户端,可将本地 AI Agent(Claude、Cursor、Cline)连接到我们的云端 GPU 视频制作工具链。
Beta 版。 Agent 可能会出错。发布或分享前,请预览每个输出。对于影响重大或不可逆的编辑,请传入
requirePlanApproval: true,这样 Agent 会在规划后暂停,并等待你批准后再执行任何操作。
目录
- 快速开始 — 60 秒内即可运行
- 功能介绍 — 说出需求,即可获得结果
- 功能范围 — 完整工具集
- 目标与创意简报 — 从一句话到完整创意简报
- API 参考 — 端点、请求/响应、流式传输、异步
- 适用对象 · 与传统编辑器的比较 · 安全性 · 媒体
- 链接与渠道
快速开始
可移植的接口是 levea-mcp-server MCP 服务——一个服务,适用于所有 MCP 客户端(Claude Desktop、Claude Code、Cursor、Cline、OpenClaw、Hermes);一套工具接口、一个后端契约,因此不同平台之间不会出现差异。
1. 获取 API 密钥 — 在 livecore.ai 注册并生成 OpenClaw API 密钥。
2. 添加 MCP 服务 — 同一条 npx 命令适用于所有 MCP 客户端:
{
"mcpServers": {
"levea": {
"command": "npx",
"args": ["-y", "levea-mcp-server"],
"env": {
"LEVEA_API_URL": "https://api.livecore.ai",
"LEVEA_API_KEY": "your-key-from-livecore.ai"
}
}
}
}
3. 开始使用 — 对 AI 说:“使用 levea 工具,从这段视频中生成 5 个热门短片,添加字幕,并改为竖屏。” Agent 会选择工具并填写提示词;编辑器会规划 → 执行 → 导出。
各客户端的配置方法
| 客户端 | 方法 |
|---|---|
| Claude Desktop / Cursor / Cline | 将上面的 levea 配置块添加到 mcpServers — 请参阅 levea-mcp-server 文档 |
| Claude Code | claude mcp add levea -e LEVEA_API_URL=https://api.livecore.ai -e LEVEA_API_KEY=... -- npx -y levea-mcp-server |
| OpenClaw | 使用此 ClawHub 页面(原生聊天)或 openclaw mcp add levea --command "npx -y levea-mcp-server" --env LEVEA_API_URL=https://api.livecore.ai --env LEVEA_API_KEY=... |
| Hermes | 在 Hermes 配置中将 levea-mcp-server 注册为 MCP 服务 |
npm 上的此软件包:
npx -y levea-mcp-server— 无需全局安装。
托管端点 — 无需安装
通过 URL 连接远程 MCP 服务的客户端(Smithery、Claude / ChatGPT 连接器、Cursor 远程服务)可以完全跳过 npx:
URL: https://api.livecore.ai/api/v1/misc/mcp (Streamable HTTP, stateless)
Header: Authorization: Bearer your-key-from-livecore.ai
工具和后端都相同。无法设置请求头的客户端可以改用 ?apiKey=...。无需密钥即可查看工具列表;编辑则需要密钥。
每个客户端都会调用同一个后端——MCP 服务、此 ClawHub 页面及其他所有入口都共用同一套工具契约。
两个主机 — 请勿混淆
| 主机 | 用途 |
|---|---|
| https://api.livecore.ai | 功能 API。设置为 LEVEA_API_URL。客户端会自动追加 /api/v1/misc/openclaw/v1/execute;此处切勿填写完整路径。 |
| https://livecore.ai | API 密钥门户(UI)。在此获取密钥。不要将其用作 LEVEA_API_URL。 |
环境变量为
LEVEA_API_URL/LEVEA_API_KEY。
AI 可见的工具
一个编辑入口。其余都是有类型的状态管理和轮询——这样集成方只需一个 API 密钥,就能构建完整的编辑体验,无需混用 JWT 和 MCP。
| 分组 | 工具 |
|---|---|
| 编辑(一个入口,3 种变体) | autonomous_edit(主要入口,JSON) · autonomous_edit_streaming(SSE — 按步骤显示进度) · queue_edit(异步即发即弃) |
| 作业 / 任务轮询 | check_job_status · check_task_status · get_active_task |
| 字幕模板 | list_caption_templates · apply_caption_template · save_caption_template · save_current_caption_template · delete_caption_template(41 个内置模板 + 你保存的模板) |
| 品牌套件 | list_brand_kits · get_brand_kit · create_brand_kit · update_brand_kit · delete_brand_kit(调色板 · 字体 · 徽标 · 语气 · gradeBias · 强制规则) |
| 项目 | list_projects · get_project · create_project · delete_project |
| 资源 | asset_upload_url(签名 PUT) · list_assets · delete_asset · transcribe_asset |
| 诊断 | editor_health |
没有编辑垫片(add_captions、generate_viral_clips 等),也没有 editor_execute 这样的逃生入口。后端规划器就是专家——将编辑功能拆散会促使调用方让大模型对规划器的决策进行二次判断,并丢失多步骤意图。状态管理工具(品牌 / 项目 / 资源 / 字幕模板的 CRUD)不属于编辑,因此不会拆散意图——它们只是为集成方提供有类型的访问方式。
→ 如需了解 Agent 集成详情(架构、异步语义、错误处理、计划审批),请参阅 AGENTS.md。
功能介绍
用简单明了的语言提出要求;Agent 会规划并完成编辑。
| 你的要求 | 它会执行 |
|---|---|
| “把这个剪成 5 个容易走红的短视频片段,添加字幕并调整为竖屏构图” | 挑选最佳片段、剪辑、添加字幕、调整构图并导出 |
| “从这段 2 小时的播客中剪出一个 60 秒的精彩集锦” | 找出叙事高潮、剪辑片段并添加字幕 |
| “把这个视频做成适合 TikTok 的版本” | 调整为竖屏 9:16 构图 + 添加字幕 + 删除静音片段 + 强调效果套件 |
| “导出适用于 TikTok、Reels、Shorts、YouTube 和 Instagram 的版本” | 一次处理,将所有宽高比的版本打包导出 |
| “把绿幕换成海滩背景,并让演讲者保持在画面中央” | 一次调用即可完成色度键抠像 + 背景合成 + 运动跟踪 |
| “移除背景——没有绿幕” | 通过 Alpha 遮罩使用 AI 移除背景(适用于任何素材) |
| “把我的背景换成城市天际线——没有绿幕” | AI 遮罩干净地移除主体,然后将新背景合成到主体后方 |
| “移除所有静音片段和填充词,并添加背景音乐” | 清理音轨,并在语音下方添加自动降低音量的音乐 |
| “自动放大当前发言者” | 检测当前发言者 + 动态跟随变焦取景 |
| “给这个视频加字幕,并在每次说到‘launch’时突出显示” | 自动生成字幕 + 关键词强调(缩放 / 发光 / 脉冲) |
| “找出 Alex 出现的所有片段” | 跨素材的人脸身份搜索 |
| “在开场部分用克隆的声音添加旁白” | 声音克隆 + TTS 叠加 + 自动降低音量 |
| “用 Hormozi 风格添加字幕,并逐词突出显示,做成卡拉 OK 效果” | 逐词同步的卡拉 OK 字幕——当前词随语音节奏填充 + 加下划线 |
| “在提到产品的部分生成 B-roll” | 生成 AI B-roll + 放置在合适的时间点 |
| “把这个视频调成 Netflix 纪录片的风格” | 使用电影感预设进行调色 |
| “高潮部分做慢动作,并在揭晓时定格” | 调整速度(慢动作 / 快进)+ 定格画面 |
| “调整为竖屏构图,但不要裁掉下方的字幕条” | 添加字幕安全区的 9:16 构图(检测屏幕文字区域并围绕其调整构图) |
| “提取其中的关键数据,并将其制作成动态图表” | 根据转录内容生成图表 + 数据重点提示动态图形 |
| “同步这 3 个机位,并根据当前发言者在它们之间切换” | 多机位同步 + 自动切换角度 |
| “模糊车牌并消除脏话” | 隐私信息打码 + 脏话清理 |
功能一览
提示词背后的完整工具集。以下所有功能都可以通过自然语言调用——用一句话组合多种功能。
🔍 读取与检查
- 场景状态 — 时间线 / 图层 / 场景结构,架构自省
- 搜索 — 素材库(类型、时长、名称);转录文本(关键词、语义、时间戳)
- 视觉分析 — CV 帧分析(物体、人脸、场景);屏幕文字区域检测(定位字幕条 / 下三分之一字幕 / 烧录字幕,避免调整构图时遮挡它们)
- 智能分析 — 叙事高潮、说话者分离、情感、节奏
- 任务 — 异步任务状态轮询
✂️ 结构化编辑
- 图层 — 插入 / 更新 / 替换 / 删除(视频、音频、图像、文本、形状、纯色、调整、组、灯光、VFX、可视化工具、lottie)
- 时间 — 修剪、拆分、变速(慢动作 0.5×、快进 2×、定格画面)、倒放、稳定
- 排列 — 重新定位、排序、按转录文本中的词语边界吸附
- 组装 — 多机位同步 + 自动切换角度、蒙太奇组装(从源素材中发现镜头并排序)、幻灯片生成、章节标记、SRT 导入
- 安全处理 — 修复间隙、音频标准化、时长校准(导出前处理)、多步撤销 / 重做
🎬 视觉编辑
- 调色 — 亮度、对比度、饱和度、色相、提升/伽马/增益、RGB 曲线、LUT/胶片风格预设、暗角、色差
- VFX 着色器 — 烟雾、灰尘、火焰、爆炸、闪电、雪、故障效果、扫描线、颗粒、玻璃拟态、散景、熔岩、腐蚀、传送门
- 合成 — 色度键控、AI 背景移除(Alpha 遮罩)、蒙版(亮度/Alpha/深度,支持布尔多重蒙版)
- 混合与不透明度 — 17 种混合模式(正片叠底、滤色、叠加、颜色减淡/加深、差值、色相/饱和度/颜色/亮度、相加)+ 单图层和组不透明度
- 形状与变换 — 剪辑形状(圆形、穹顶、星形、六边形、多边形)、裁剪、3D 旋转/透视、辉光、阴影、渐变填充
- 照明 — 最多 8 个场景灯光,可照亮经过 3D 变换的图层
- 重新构图与布局 — 适合字幕的竖屏重新构图(9:16)+ 竖屏蒙太奇、分屏(上/下、左/右、画中画、网格)
- 跟踪 — 动作/人脸跟踪及缩放跟随、品牌叠加层
📊 动态图形与数据可视化
30 多种可用于生产环境的动画图形:
- 数据 — 由转录文本驱动的图表(柱状图、折线图、饼图)、统计数据标注、动画计数器
- 下三分之一与卡片 — 下三分之一、标题/章节卡片
- 图表 — 流程图、时间线、地理位置标注
- CTA — 动画订阅/行动号召按钮
💬 字幕与文本
- 生成 — 根据转录文本自动生成字幕
- 样式 — 内置模板,或由 AI 导演在运行时挑选/生成
- 动画 — 逐词动画(打字机、滑入、淡入、缩放、旋转、弹跳、翻转、摇摆、弹性、模糊、故障效果、波浪——每种动画都有对应的退出效果)
- 排版 — 清晰且可缩放的字形(MSDF)、描边/轮廓、投影、渐变填充、背景胶囊/方框、逐词卡拉 OK 填充 + 下划线
- 形状 — 曲线路径文字(圆形、波浪、自定义 SVG)、Lottie 播放控制
🎵 音频
- 清理 — 移除静音、呼吸声、填充词;逐词静音/剪切
- 混音 — 自动闪避(侧链音乐与人声)、响度(LUFS)标准化 + 真峰值限制、降噪、交叉淡化、EQ 预设(增强低音、人声清晰、温暖、明亮)、音轨分离
- 生成 — 音效、音乐(情绪/流派/BPM)、配音(TTS 或克隆声音)
- 同步 — 对齐外部主音频(时间码/明确偏移量)
- 可视化 — 波形(柱状、波浪、圆形)
🔒 隐私与清理
- 人脸 — 模糊所有人脸或仅模糊背景中的人脸
- 区域 — 隐私遮盖(模糊/覆盖)
- 语言 — 清理脏话(静音/哔声)
- 布局 — 修复安全区域
✨ 异步生成
- 视频 — AI 视频/B-roll(时长 + 宽高比)
- 图像 — AI 图像(单张或按时间戳批量生成)、生成式图像编辑、自动提取缩略图
- 音频 — AI 音乐(提示词 + 时长 + 情绪 + 流派 + BPM)、AI 配音(TTS 或克隆声音库)
🚀 高级预设
- 病毒式传播 — 竖屏 + 字幕 + 移除静音 + 跟踪 + 逐词强调
- 电影导演 — 动态缩放 + 电影级调色 + 情绪化镜头运动
- 强调系统 — 关键词检测 + 协同缩放/辉光/脉冲
- 节奏优化器 — 移除填充词、静音和低能量片段,以提高留存率
📦 导出
- MP4 — 单个文件(分辨率/编解码器/质量等级)
- 病毒式短片批量处理 — 自动分段的短视频,打包为 ZIP
- 多平台套装 — 一次处理 TikTok + Reels + Shorts + YouTube + Instagram
✅ 另已提供
- 内容感知修复(LaMa)— 通过
REPLACE_ON_SCREEN_TEXT和移除叠加层功能,移除屏幕上的文字、标志和水印 - 屏幕文字 OCR 识别 — PP-OCRv5 检测 + 识别结果填充
TextRegion.text,以便查找并替换烧录文字
目标与创意简报
autonomous_edit 接受的内容范围很广,从五个词的命令到五百字的创意简报皆可。
1. 直接命令 — 一次编辑,单一结果。上文功能介绍中的示例都是直接命令。
2. 开放式目标 — 将一个目标而非命令交给 Agent;它会检查素材,然后提出计划:
"Watch this and tell me how to make it more engaging for TikTok"
"Look at the first 30 seconds and suggest 3 ways to hook the viewer"
"Review this footage and propose edits to tighten the pacing"
将这些内容与 requirePlanApproval: true 配合使用,即可进入仅提议模式 — Agent 会在制定计划后停止,等待你的批准(参见计划审批)。
3. 完整创意简报 — 端到端执行的多步编排。Agent 会将简报分解为由规范操作组成的 DAG,规划执行顺序,通过安全门执行,验证每个步骤,并导出所有要求的格式。使用 SSE 实时查看每个步骤的完成情况。
简报示例(一次计划运行中组合约 20 个操作)
将此视频改造成一部适合社交媒体传播的热门纪录片。首先剪掉开头 3 秒和结尾 5 秒,以去除无声片段。应用暖色调、高对比度的电影级调色。生成自动字幕,使用粗体黄色文字和黑色描边,并放置在底部居中位置。在前 10 秒内为主体添加动态推近效果。在演讲者提到视觉概念时插入 3 段相关的 B-roll 视频片段。转换为适用于 TikTok 和 Reels 的竖屏 9:16 格式时,应用人脸跟踪,使主体保持居中。添加符合视频氛围的欢快背景音乐,并在演讲者说话时自动降低音量。移除所有超过 0.5 秒的静音片段。应用微妙的暗角效果。在右上角添加我的 Logo 水印,透明度设为 80%。从表现力最丰富的画面生成自定义缩略图,并添加醒目的“MUST WATCH”文字。创建一个动画订阅按钮,在 5 秒时出现并闪动。为转场添加呼啸音效。应用降噪。于 30 秒处拆分视频并插入 2 秒转场。为关键统计数据添加动画计数器叠层。为背景中的人脸添加模糊效果,以保护隐私。导出 1080p 的 YouTube 版本,以及针对 TikTok、Reels 和 Shorts 优化、采用各平台专属宽高比的版本。
无需时间线界面,无需逐步调用 API,也无需编写胶水代码。
API 参考
基础 URL:{LEVEA_API_URL}(生产环境:https://api.livecore.ai)。每个请求都需要进行身份验证:
Authorization: Bearer {LEVEA_API_KEY}
所有路径均位于 /api/v1/misc/openclaw 下。
| Endpoint | Purpose |
|---|---|
POST /v1/execute | 运行 autonomous_edit(主要入口) |
POST /v1/queue-edit | 发起即弃式异步编辑 |
GET /v1/jobs/{jobId} · GET /v1/task-status/{taskId} | 轮询异步渲染 / 生成任务 |
GET /v1/projects/{id}/active-task | 获取项目当前正在执行的任务(如有) |
GET /v1/tools · GET /v1/health | 列出工具名称 · 健康检查 |
/v1/brands · /v1/projects · /v1/assets/* | 品牌套件 / 项目 / 素材的 CRUD — 列出 · 获取 · 创建 · 更新 · 删除 |
/v1/caption-templates (+ /apply, /save-current) | 字幕模板的 CRUD + 应用 |
上述每个管理类别也都以类型化的 MCP 工具形式提供(参见 AI 可见的工具)。
LEVEA_API_URL是纯主机地址https://api.livecore.ai— 不是完整路径,不是livecore.ai,也不是产品内的/api/v1/misc/editor/路由。
请求
每次编辑都通过一个工具完成 — autonomous_edit。传入自然语言描述;Agent 会规划、执行、验证并导出。无需记忆工具列表,也无需学习结构化参数。
curl -sS -X POST "$LEVEA_API_URL/api/v1/misc/openclaw/v1/execute" \
-H "Authorization: Bearer $LEVEA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tool": "autonomous_edit",
"params": {
"prompt": "Make this a TikTok-ready viral clip: vertical reframe, bold captions, remove silences, motion-track the speaker, and export."
},
"project_id": "my-project"
}'
prompt 是唯一必填字段。其他字段均为可选:
| 字段 | 作用 |
|---|---|
prompt | 用用户自己的话描述要执行的视频编辑。(必填) |
project_id | 之前调用返回的项目标识符;对同一视频进行后续编辑时都要重复使用。 |
video_url | 开始新项目时使用的公开视频源 URL。 |
assets | 作为公开 HTTP/HTTPS URL 的输入媒体(视频、图像、音频)。 |
scene | 要继续编辑的现有场景/时间线状态(高级)。 |
captionTemplatePreset | 要应用的字幕模板 ID:内置标识(例如 hormozi、viral-pop、karaoke)或已保存的模板 ID。调用 list_caption_templates 获取确切 ID。 |
captionTemplateMode | 应用 captionTemplatePreset 的方式:add、recreate、style、translate、clear、remove_fillers 之一。 |
requirePlanApproval | 为 true 时,规划后暂停并返回 workingMemory,供用户审批。 |
workingMemory | 暂停的计划审批调用返回的状态;将其发回以继续。 |
editedPlan | 用户编辑后的计划版本,该计划由审批暂停调用返回。 |
attachedImages | 用于规划的参考图像 URL(风格、品牌)。 |
flaggedIssues | 用户指出的、此轮运行必须修复的具体问题。 |
brandId | 应用于此次调用的品牌套件。 |
projectBrandId | 项目的默认品牌套件;会在多次调用间保留。 |
core_only | 仅返回渲染必需的场景字段(响应更小)。 |
响应
{
"type": "success | partial_success",
"tool": "autonomous_edit",
"success": true,
"partial": false,
"status": "completed | failed | awaiting_approval",
"scene": { },
"reply": "Human-readable summary of what changed",
"message": "Short status message",
"videoUrl": "https://.../output.mp4",
"jobId": "12345",
"viral_clips": [ ],
"zip_url": "https://.../clips.zip",
"activeTasks": [ ],
"pendingAsyncJobs": [ ],
"verificationPassed": true,
"verificationIssues": [],
"quality": {
"score": 0.94,
"stepsTotal": 7,
"stepsFailed": 0,
"hasExportedMedia": true,
"mediaReachable": true
},
"processingTime": 12.3,
"workingMemory": { }
}
jobId 是数字形式的 task_id(由数字组成的字符串),而不是带 task_ 前缀的值。quality 是校准后的运行后评分块;partial 是顶层的部分成功标志(与 type: "partial_success" 对应)。
SSE 流式传输
设置 Accept: text/event-stream 或 ?stream=true。值得关注的事件类型:
| 事件 | 含义 |
|---|---|
heartbeat | 每 15 秒发送一次的保活信号 |
status · phase | 阶段/状态转换 |
thought · reasoning_chunk | 显示逐步推理过程 |
tool_call · tool_result | 操作开始/完成 |
background_job_completed | 异步任务已完成 |
success / partial_success | 终止负载 |
error | 终止失败 |
异步任务生命周期
生成操作会立即返回 jobId。持续轮询,直到任务进入终止状态:
JOB_ID=$(jq -r '.jobId // .activeTasks[0].intent.job_id' /tmp/result.json)
while true; do
STATUS=$(curl -sS "$LEVEA_API_URL/api/v1/misc/openclaw/v1/jobs/$JOB_ID" \
-H "Authorization: Bearer $LEVEA_API_KEY" | jq -r '.status')
echo "Status: $STATUS"
case "$STATUS" in completed|succeeded|failed|error|cancelled) break;; esac
sleep 5
done
curl -sS "$LEVEA_API_URL/api/v1/misc/openclaw/v1/jobs/$JOB_ID" \
-H "Authorization: Bearer $LEVEA_API_KEY" | jq '.result'
自动导出
在任何更改了场景的修改型工具调用之后(包括部分成功),如果尚未加入导出队列,路由会同步自动触发导出 — 因此响应会携带真实的 videoUrl。只读和对话式的 autonomous_edit 调用不会触发自动导出。
计划审批
传入 requirePlanApproval: true,让 Agent 在规划后停止。它会返回 status: "awaiting_approval" 和已填充的 workingMemory。发送相同的 workingMemory 并附上审批提示(yes、approve、go、do it、confirm)即可继续。
适用对象
| 受众 | 收益 |
|---|---|
| 创作者和网红 | 长视频 → TikTok / Reels / Shorts · 自动字幕 · 爆款片段生成 · AI 缩略图 |
| 播客创作者 | 视频播客精彩片段 · 音频图 · 多机位剪辑 · 去除静音和填充词 |
| 营销人员和代理机构 | 大规模制作广告 · 面向社交媒体的内容再创作 · 品牌叠加自动化 · 多平台导出 |
| 教育工作者和课程创作者 | 教程剪辑 · 自动章节划分 · 标题 / 章节卡片 · 自动字幕 · 逐词强调 |
| YouTube 创作者 | 长视频 → Shorts 工作流 · 缩略图生成 · 片头 / 片尾自动化 · 章节标记 |
| 销售和 SaaS | 产品演示 · 操作指南精彩片段 · 克隆语音旁白 |
| 活动团队 | 网络研讨会 / 会议精彩片段 · 多机位拼接 · 演讲者聚焦短片 |
| 信仰团体和社区 | 用于社交媒体的布道片段 · 信息精彩片段 · 多平台内容打包 |
与传统编辑器的对比
| 传统编辑器(Premiere、DaVinci、CapCut、Descript) | Levea MCP Server | |
|---|---|---|
| 界面 | 手动拖放、设置关键帧 | 一句话,其余交给 Agent 完成 |
| 上传时自动分析 | 手动检测场景和添加字幕 | 自动检测人脸、说话者、镜头、屏幕文字区域和遮罩 |
| “让它火起来” | 由你搭建工作流 | 单个预设——竖屏 + 字幕 + 静音片段处理 + 跟踪 |
| 跨素材搜索 | 按文件名搜索 | 在整个素材库中“查找 Alex 出现的所有片段” |
| 替换背景 | 抠像、查找背景、合成 | 一次调用 |
| 广播级音频 | 手动测量响度 + 均衡 | 自动进行 LUFS 响度标准化 + 真峰值限制,并在语音下方自动压低音乐音量 |
| 编辑判断 | 由你决定高潮部分 | Agent 挖掘叙事高潮和反应时刻 |
| 验证 | 由你目测检查 | 执行后运行验证器;失败时自动修复 |
| 多平台导出 | 每种画幅单独渲染一次 | 一次处理即可导出 TikTok + Reels + Shorts + YouTube + Instagram |
| 可扩展性 | 插件调用外部二进制程序 | 按名称调用类型化工具 |
这不是一个简单拼装了 AI 功能的编辑器——而是一个能自主替你完成剪辑的 Agent。
安全与限制
- Beta 版——输出可能有误。分享前请预览每个结果。对于不可逆工作流,传入
requirePlanApproval: true,先检查并批准计划。 - 每个请求都需要通过 API 密钥进行身份验证。
- 破坏性操作(批量删除、清空)需要明确的确认参数。
- 执行后会验证输出;失败时自动修复。
- 服务端会对并发的相同请求进行去重。
- 按 API 密钥进行速率限制。只读操作约 1–3s · 结构性编辑约 3–10s · 异步生成每项内容需 30s–5min · 爆款片段 / 多平台导出需数分钟。
支持的媒体
| 格式 | |
|---|---|
| 视频输入 | MP4、MOV、WebM(HTTP/HTTPS URL、YouTube URL、图库 ID) |
| 图片输入 | JPG、PNG、WebP |
| 音频输入 | MP3、WAV、M4A、AAC(或从视频中提取) |
| 输出 | MP4(导出)、ZIP(爆款片段 / 多平台包) |
| 最长视频时长 | 每项素材最长 3 hours(取决于计划);支持同步编辑和异步生成 |
| 推荐分辨率 | 1080p 或 4K;可按项目配置画布 |
链接与渠道
| 渠道 | 标识符 / 链接 |
|---|---|
| npm(MCP 服务) | levea-mcp-server |
| MCP Registry | io.github.brajendrak00068/levea-mcp-server (注册表) |
| ClawHub 插件 | openclaw-ai-video-editor |
| ClawHub 技能(Agentic) | ai-agentic-video-editor |
| ClawHub 技能(Levea 品牌) | levea-ai-video-editor |
| 注册 + API 密钥 | livecore.ai |
| API 基础地址 | https://api.livecore.ai |
此处未锁定版本 —
npx -y levea-mcp-server和 ClawHub 列表始终会获取最新版本,链接中的 npm / ClawHub 页面会显示当前版本。无需指定特定版本号。
支持 — 设置帮助、集成问题或问题报告:[email protected]
许可证 — MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。