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）
• 添加音效、生成音乐（根据情绪/类型/速度）、生成配音（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 URL、画廊 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'