Levea 自主视频编辑器（OpenClaw）

一个完整的自主型视频编辑工作台。输入自然语言指令，即可获得经过规划、验证并执行的视频编辑结果。该自主编辑器可自行选择内部工具，应用安全检查机制，在需要时导出成果，并返回最终的视频片段。

在用户请求 OpenClaw 视频编辑、AI 视频编辑、自然语言视频编辑、爆款短视频、TikTok 视频、Instagram Reels、YouTube Shorts、自动字幕、字幕生成、色度键（绿幕）去除、背景移除、B-roll 配乐、运动追踪、动态图形、多机位剪辑、智能跳切、静音段清理、音频净化、配音、音乐生成、物体模糊/隐藏、人脸模糊、隐私信息遮蔽、节拍同步、品牌模板、缩略图、风格预设、竖屏视频、安全区域修复、最终交付检查、导出设置、多平台导出或 MP4 导出等场景时，请使用此技能。

测试版：此技能目前处于测试阶段，输出结果可能不准确。在对用户内容执行任何可能修改的操作前，请先描述计划中的编辑内容，并获取用户的明确确认。对于具有破坏性或不可逆的流程，请传递 requirePlanApproval: true，使编辑器在完成规划后暂停，等待用户批准后再继续执行。

接口地址

POST {ADSCENE_API_URL}/api/v1/misc/openclaw/v1/execute

认证方式：Authorization: Bearer {ADSCENE_API_KEY}

请前往 Studio 创建账户并生成 OpenClaw API 密钥：https://studio.livecore.ai/

API 地址使用 https://api.livecore.ai；Studio 仅用于注册、登录和密钥管理。

支持单次请求 JSON（默认）或 SSE 流式传输（通过 Accept: text/event-stream 或 ?stream=true 指定）。

请求体格式：

{
  "tool": "autonomous_edit",
  "params": { ... },
  "project_id": "optional-project-id",
  "scene": { /* 可选的客户端场景；若服务端已有更新版本，则以服务端为准 */ }
}

使用方法

每次编辑仅需调用一个工具：**autonomous_edit**。在 params.prompt 中传入自然语言描述。代理将自动识别意图，拆解为原子操作步骤，制定计划，通过安全检查，执行并验证结果。无需学习其他工具。

curl -sS -X POST "$ADSCENE_API_URL/api/v1/misc/openclaw/v1/execute" \
  -H "Authorization: Bearer $ADSCENE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "autonomous_edit",
    "params": {
      "prompt": "制作一个适合 TikTok 的爆款短视频：竖屏重构，添加醒目字幕，移除静音段，并对发言人进行运动追踪。"
    },
    "project_id": "my-project"
  }'

在一次 autonomous_edit 调用背后，代理可组合以下各类功能：

读取 / 检查

• 检查时间线结构、图层属性及当前场景状态
• 对帧进行计算机视觉分析（对象/人脸/场景检测）
• 通过关键词、语义或时间窗口搜索字幕文本
• 获取视频智能信息（叙事高潮点、说话人区分、情感分析、节奏判断）
• 根据类型、时长、名称等条件搜索素材库（视频、图片、音频）
• 查询异步任务状态；查看属性模式结构

结构化编辑

• 插入 / 更新 / 替换 / 删除图层（视频、音频、图像、文字、形状、纯色、调整、组、灯光、特效、可视化器、Lottie）
• 裁剪、分割、重定时间轴（慢放 0.5×、快进 2×、定格画面）
• 智能跳切、填充词删除、静音段清理、低能量片段移除
• 重新定位时间轴位置，排列图层顺序，与字幕对齐
• 多机位同步与角度切换（按节奏、说话人优先级或镜头大小）
• 修复时间线空隙，均衡音频，统一时长（导出前的安全检查）
• 支持多步撤销 / 重做

视觉编辑

• 色彩校正（亮度、对比度、饱和度、色调、提升/伽马/增益、RGB 曲线）
• 程序化 VFX 着色器：烟雾、灰尘、火焰、爆炸、闪电、雪花、故障、扫描线、颗粒感、玻璃态、景深、熔岩、端粒/腐蚀、传送门
• 色度键（绿幕 / 蓝幕），支持相似度、平滑度、溢色控制；支持亮度 / 透明度 / 深度蒙版
• 几何裁剪形状（圆形、穹顶形、星形、六边形等）
• 裁剪（绝对坐标或边缘基准）、3D 旋转 + 透视变形
• 发光、阴影、内阴影、渐变填充、文字渐变
• 竖屏重构（9:16）及竖屏蒙太奇
• 分屏（上下、左右、画中画）
• 品牌叠加与品牌模板（Logo / 水印 / 颜色 / 字体 / 声音）来自素材库、项目品牌设置或 AI 生成
• 运动 / 人脸追踪，支持动态缩放跟随
• 物体隐藏 / 物体模糊、局部人脸模糊、隐私信息遮蔽、安全区域修复

字幕与文字

• 从字幕自动生成字幕
• 使用内置模板或由 AI 导演实时选择/生成自定义模板
• 动态图形：动能字幕、下三分之一、数据标注、图表、对比叠加、概念图标 Lottie 图层
• 弧形文字路径（圆形、波浪、自定义 SVG）
• 每个字的入场 / 退场动画（打字机、滑动、淡入淡出、缩放、旋转、弹跳、翻转、摆动、弹性、模糊、故障、波浪，以及匹配的退场效果）
• Lottie 动画播放控制

音频处理

• 音频净化：移除静音、呼吸声、填充词；支持逐词静音或删除
• 敏感词清理：对违规词汇进行静音、哔声或删除
• 语音检测触发的自动音量衰减（侧链音乐与人声）
• 混音 / 均衡 / 降噪 / 均衡（低音增强、人声清晰度、温暖、明亮）
• 同步外部主音频至视频（偏移、关闭摄像机音频）
• 节拍 / 鼓点同步剪辑（提供 beat_times 或 bpm）
• 添加音效，生成音乐（情绪 / 风格 / BPM），生成配音（TTS 或克隆声音）
• 渲染波形可视化器（条形、波形、环形）

异步生成

• AI 视频 / B-roll — 持续时间 + 画面比例
• AI 图像 — 在指定时间戳处生成单张或批量图像
• AI 音乐 — 提示词 + 持续时间 + 情绪 + 风格 + BPM
• AI 语音旁白 — TTS 或克隆语音库
• 自动提取缩略图 或 生成 AI 编辑的缩略图变体
• 人脸模糊（全部人脸或仅背景）

高级编辑套件（每个均为单一标准操作，可协调多个底层编辑动作）

• APPLY_VIRAL_KIT — 垂直重构 + 字幕 + 静音段移除 + 运动追踪 + 强调效果
• APPLY_CINEMATIC_DIRECTOR — 能量分析 + 动态缩放 + 电影级调色 + 基于情绪的镜头运动
• APPLY_EMPHASIS_SYSTEM — 关键词检测 + 与字幕同步的缩放 / 发光 / 脉冲效果
• OPTIMIZE_PACING — 移除填充词、静音段及低能量片段以提升留存率

导出功能

• EXPORT_VIDEO — 渲染为 MP4（分辨率 / 编解码器 / 质量等级）
• EXPORT_PRESET — 平台 / 编解码器 / 画面比例预设，并自动修复安全区域
• FINAL_DELIVERY_CHECK — 验证安全区域、时间线完整性、字幕、媒体资源及导出就绪状态
• GENERATE_VIRAL_CLIPS — 自动生成短视频片段并打包为 ZIP 文件
• GENERATE_MULTI_PLATFORM — 一次性生成 TikTok + Reels + Shorts + YouTube + Instagram 所需的画面比例

自动导出后续流程

在任何一次 会修改场景内容 的 autonomous_edit 调用后，若场景确实发生变化且代理未提前排队导出，则系统将自动触发一次导出作为第二次运行。最终响应中会携带 videoUrl（准备就绪时）或 jobId（用于轮询）。仅读取或对话类的 autonomous_edit 调用不会触发自动导出。

可选输入参数（与产品内编辑器功能对齐）

可在 params 中（或请求体顶层）传入以下任意参数，以驱动高级功能：

• prompt — 每次调用均需提供（自然语言形式的编辑描述）
• workingMemory — 持久化的工作记忆快照。在 awaiting_approval 后恢复时需重新发送
• requirePlanApproval — 设为 true 时，代理将在规划完成后暂停并返回 awaiting_approval；通过相同的 workingMemory 加上批准提示（如 "yes"、"approve"、"do it" 等）继续执行
• attachedImages — base64 编码的截图或参考图像数组
• flaggedIssues — 描述用户希望修复的具体问题字符串数组
• captionTemplatePreset, captionTemplateMode — 字幕生成的样式预设路由
• brandId, projectBrandId — 可选的品牌套件选择，用于指定颜色、字体、Logo、调色倾向和语音风格
• core_only（也支持通过 ?core_only=true 传递）—— 返回最小化的场景结构（仅渲染相关，不含调试字段）
• assets — 额外的资产描述符，供代理使用

响应格式

JSON（默认）

{
  "type": "success" | "partial_success",
  "tool": "<工具名称>",
  "success": true,
  "status": "completed" | "failed" | "awaiting_approval",
  "scene": { /* 更新后的场景数据 */ },
  "reply": "对变更内容的人类可读摘要",
  "videoUrl": "https://.../output.mp4",
  "jobId": "1234567",
  "viral_clips": [ /* 若生成则包含片段元数据 */ ],
  "zip_url": "https://.../clips.zip",
  "activeTasks": [ /* 已排队的后台任务列表 */ ],
  "pendingAsyncJobs": [ /* 正在进行中的异步任务状态 */ ],
  "workflowStepsDetailed": [ /* 执行过的每一步详情 */ ],
  "workflowSummary": { "title": "...", "summary": "..." },
  "verificationPassed": true,
  "verificationIssues": [],
  "committedToProjectScene": true,
  "processingTime": 12.3,
  "message": "与 reply 内容相同",
  "workingMemory": { /* 下次调用时用于恢复审批暂停流程的快照 */ }
}

失败响应（HTTP 4xx/5xx）：

{ "success": false, "error": "...", "code": "MISSING_PROMPT" | "EXECUTION_ERROR" }

SSE（Accept: text/event-stream 或 ?stream=true）

与产品内编辑器使用的相同事件流。重要事件类型包括：

• heartbeat — 每 15 秒一次，保持连接活跃
• status — 阶段转换（如 request_received, runtime_start 等）
• mode_select — { mode: "qa" | "action" }
• thinking, tool_call, tool_result — 每一步推理过程的可见性
• background_job_completed — 异步任务完成（如 B-roll、病毒式剪辑等）
• workflow_completed — 主脑循环结束，验证可能仍在进行
• success / partial_success — 最终终止负载（与 JSON 格式相同）
• error — 终止性错误

异步任务生命周期

生成类操作（generate_*, EXPORT_VIDEO）立即返回，并在 activeTasks / pendingAsyncJobs 中包含 jobId。可通过以下方式轮询状态：

GET {ADSCENE_API_URL}/api/v1/misc/openclaw/v1/jobs/{jobId}
Authorization: Bearer {ADSCENE_API_KEY}

响应内容：

{
  "success": true,
  "jobId": "1234567",
  "status": "queued" | "processing" | "completed" | "failed",
  "progress": 0.74,
  "message": "正在渲染第 142 帧，共 192 帧",
  "result": { /* 完成后返回的成果链接 / 片段元数据 */ },
  "error": null,
  "createdAt": "...",
  "updatedAt": "..."
}

当异步生成内容完成后，代理会通过内部调用 APPLY_PENDING 将其拉取至时间线。autonomous_edit 调用方无需自行管理此流程；但直接调用者可发出类似 "apply any pending generated content" 的提示来主动获取。

计划审批流程

若传入 requirePlanApproval: true，代理将在规划阶段停止，并返回 status: "awaiting_approval" 以及完整的 workingMemory。要继续，请再次调用：

{
  "tool": "autonomous_edit",
  "params": {
    "prompt": "yes",
    "workingMemory": { /* 上次响应中的 workingMemory */ }
  }
}

接受的批准语句：yes, y, approve, approved, go, proceed, go ahead, do it, confirm。

安全性、验证与限制

每个执行流程都会经过三个确定性检查节点：ActionPermissionGate、ArchitectureControlPlane 和 EditorSafetyPolicy。破坏性操作（如 CLEAR、批量删除）需要显式确认参数。执行后会进行验证，最多可触发 2 次修复循环；若失败，将返回 verificationPassed: false 以及 verificationIssues[] 列表。针对同一 (user, project, prompt, scene fingerprint) 的并发相同请求会在服务端自动去重。

按 API Key 进行速率限制。处理时间因操作类型而异：只读操作约 1–3 秒，结构化编辑约 3–10 秒，异步生成每项素材耗时 30 秒至 5 分钟，病毒式传播剪辑 / 多平台导出则需数分钟。

支持的格式

• 视频输入：MP4、MOV、WebM（支持 HTTP/HTTPS URL、YouTube 链接、画廊 ID）
• 图像输入：JPG、PNG、WebP
• 音频输入：MP3、WAV、M4A、AAC（或从视频中提取）
• 输出格式：MP4（导出）、ZIP（病毒式剪辑 / 多平台打包）
• 最大视频长度：单个素材最长可达约 3 小时（取决于计划配置）；支持同步编辑与异步生成
• 推荐分辨率：1080p 或 4K；画布尺寸可按项目配置

示例：端到端病毒式剪辑生成

# 1) 启动病毒式剪辑流水线（自动触发后续导出队列渲染）
curl -sS -X POST "$ADSCENE_API_URL/api/v1/misc/openclaw/v1/execute" \
  -H "Authorization: Bearer $ADSCENE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "autonomous_edit",
    "params": {
      "prompt": "生成 5 个病毒式剪辑，每段 15-30 秒，聚焦最吸引人的片段。添加醒目字幕，垂直重构画面，移除静音部分。"
    },
    "project_id": "my-project"
  }' | tee /tmp/result.json | jq -r '.jobId // .activeTasks[0].intent.job_id'

# 2) 轮询任务状态直至完成
JOB_ID=$(jq -r '.jobId // .activeTasks[0].intent.job_id' /tmp/result.json)
while true; do
  STATUS=$(curl -sS "$ADSCENE_API_URL/api/v1/misc/openclaw/v1/jobs/$JOB_ID" \
    -H "Authorization: Bearer $ADSCENE_API_KEY" | jq -r '.status')
  echo "状态: $STATUS"
  [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ] && break
  sleep 5
done

# 3) 获取最终成果物的下载链接
curl -sS "$ADSCENE_API_URL/api/v1/misc/openclaw/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $ADSCENE_API_KEY" | jq '.result'