Levea Agentic Video Editor#

A full agentic video-editing surface. Send a prompt and get a planned, verified, executed edit. The autonomous editor chooses its own internal tools, applies safety gates, exports when needed, and returns the final scene/video result. Every edit goes through one HTTP tool — autonomous_edit — so there is only one call to learn.

When to use this skill#

Use when the user asks for AI video editing, natural-language video edits, viral clips, TikTok videos, Instagram Reels, YouTube Shorts, auto captions / subtitles, chroma key / green-screen removal, background removal, B-roll, motion tracking, motion graphics, multi-cam editing, smart jump cuts, silence / audio cleanup, voiceover, music generation, object / face blur, privacy redaction, beat sync, brand kits, thumbnails, style presets, vertical (9:16) reframe, safe-zone repair, final delivery checks, export presets, multi-platform export, or MP4 export.

Beta: outputs can be wrong. Before executing any mutating edit on user content, describe the planned edit and ask for explicit confirmation. For destructive or irreversible workflows, pass requirePlanApproval: true so the editor halts after planning and the user can approve before execution.

Setup#

This skill calls the Levea HTTP API with curl and parses responses with jq.

Required binaries: curl, jq.

Required environment variables:

• LEVEA_API_URL — base URL for the Levea API, e.g. https://api.livecore.ai. Do not use the Studio URL or the in-product /api/v1/misc/editor route.
• LEVEA_API_KEY — API key generated from Studio at https://livecore.ai/ (sign up / sign in, then create a key). Studio is only for signup, login, and key management.

bash

export LEVEA_API_URL="https://api.livecore.ai"
export LEVEA_API_KEY="your-api-key"

Endpoint#

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

Auth: Authorization: Bearer {LEVEA_API_KEY}

Accepts single-shot JSON (default) or SSE ( Accept: text/event-stream or ?stream=true).

Request body:

json

{
  "tool": "autonomous_edit",
  "params": { "prompt": "..." },
  "project_id": "optional-project-id",
  "scene": { "_comment": "optional client scene; server-side committed scene wins if newer" }
}

How to use it#

Pass a natural-language description in params.prompt. The agent classifies intent, decomposes into atomic steps, plans, executes through safety gates, and verifies the result.

bash

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, add bold captions, remove silences, and motion-track the speaker."
    },
    "project_id": "my-project"
  }'

Behind a single autonomous_edit call the agent can compose any of:

Read / inspect — timeline + layer structure, CV frame analysis (object/face/scene), transcript search (keyword / semantic / timestamp), video intelligence (narrative peaks, diarization, sentiment, pacing), asset-gallery search, async job polling, property-schema introspection.

Structural editing — insert / update / replace / delete layers (video, audio, image, text, shape, solid, adjustment, group, light, vfx, visualizer, lottie); trim / split / retime (slow-mo, fast-forward, freeze-frame); smart jump cuts, filler-word + silence + low-energy cleanup; timeline sequencing, multi-cam sync + angle switching, gap heal, duration reconcile, multi-step undo / redo.

Visual editing — color grade (brightness/contrast/saturation/hue, lift-gamma-gain, RGB curves); procedural VFX shaders (smoke, dust, fire, lightning, snow, glitch, grain, bokeh, lava, portal, …); chroma key (similarity/smoothness/spill, luma/alpha/depth masks); clip shapes; crop + 3D rotation/perspective; glow / shadow / gradient fills; vertical reframe (9:16) + montage; split screen + PiP; brand overlays / kits; motion + face tracking with zoom-follow; object hide / blur, face blur, privacy redaction, safe-zone repair.

Captions & text — auto captions from transcript; built-in templates or an AI caption director; motion graphics (kinetic captions, lower thirds, stat callouts, charts, comparison overlays, concept-icon Lottie); curved text paths; per-word entrance / exit animations; Lottie playback control.

Audio — silence / breath / filler-word cleanup; profanity mute / bleep / cut; auto-ducking; mix / normalize / denoise / EQ; external master-audio sync; beat-synced cuts ( beat_times or bpm); SFX, music generation (mood / genre / BPM), voiceover (TTS or cloned); waveform visualizers.

Async generation — AI video / B-roll, AI images (single or batch at timestamps), AI music, AI voiceover, auto-thumbnail or AI thumbnail variants, face blur, instruction-based image edit.

High-level kits (each one canonical action orchestrating many edits) — APPLY_VIRAL_KIT, APPLY_CINEMATIC_DIRECTOR, APPLY_EMPHASIS_SYSTEM, OPTIMIZE_PACING.

Export — EXPORT_VIDEO (MP4), EXPORT_PRESET (platform / codec / aspect presets + safe-zone repair), FINAL_DELIVERY_CHECK, GENERATE_VIRAL_CLIPS (auto-segment short-form clips as ZIP), GENERATE_MULTI_PLATFORM (TikTok + Reels + Shorts + YouTube + Instagram in one pass).

Auto-export follow-up#

After an authoritatively verified mutating autonomous_edit call where the changed scene was durably committed and the agent did not already queue an export, the route fires one automatically as a second run. The final response carries videoUrl (when ready) or jobId (for polling). Partial, unverified, conflicted, read-only, and conversational calls do not trigger auto-export.

Optional input parameters#

Pass any of these inside params (or at the top level of the body):

• prompt — required on every call (the natural-language edit description)
• workingMemory — durable working-memory snapshot; re-send to resume after awaiting_approval
• requirePlanApproval — true stops the agent after planning ( awaiting_approval); resume with the same workingMemory + an approval prompt
• attachedImages — array of base64 screenshots / reference images
• flaggedIssues — array of strings describing specific problems to fix
• captionTemplatePreset, captionTemplateMode — caption style routing
• brandId, projectBrandId — brand-kit selection (colors, fonts, logo, grade bias, voice)
• core_only (also ?core_only=true) — minimal scene shape (rendering-only)
• assets — additional asset descriptors to make available to the agent

Response shape (JSON, default)#

json

{
  "type": "success",
  "tool": "autonomous_edit",
  "success": true,
  "status": "completed",
  "scene": { "_comment": "updated scene" },
  "reply": "Human-readable summary of what changed",
  "videoUrl": "https://.../output.mp4",
  "jobId": "1234567",
  "viral_clips": [],
  "zip_url": "https://.../clips.zip",
  "activeTasks": [],
  "pendingAsyncJobs": [],
  "verificationPassed": true,
  "verificationIssues": [],
  "workingMemory": { "_comment": "return this in the next call to resume approval-paused runs" }
}

Failure (HTTP 4xx/5xx): { "success": false, "error": "...", "code": "MISSING_PROMPT" }.

status is one of completed, failed, awaiting_approval.

Async job lifecycle#

Generation actions ( generate_*, EXPORT_VIDEO) return immediately with a jobId in activeTasks / pendingAsyncJobs. Poll:

bash

curl -sS "$LEVEA_API_URL/api/v1/misc/openclaw/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $LEVEA_API_KEY" | jq '{status, progress, message, result}'

status is queued | processing | completed | failed. To harvest async-generated content into the timeline, issue an autonomous_edit prompt like "apply any pending generated content".

Plan-approval flow#

With requirePlanApproval: true, the response carries status: "awaiting_approval" + a populated workingMemory. To proceed, call again with params.prompt = an approval phrase ( yes, approve, go ahead, do it, confirm, …) and the returned workingMemory.

Safety, verification, and limits#

Every run flows through three deterministic gates ( ActionPermissionGate, ArchitectureControlPlane, EditorSafetyPolicy). Destructive actions ( CLEAR, mass deletes) require explicit confirmation params. Verification runs after execution and may trigger up to 2 repair loops; failures surface in verificationPassed: false + verificationIssues[]. Identical concurrent requests for the same (user, project, prompt, scene fingerprint) are deduplicated server-side. Rate-limited per API key. Read-only ~1–3s, structural edits ~3–10s, async generation 30s–5min per artifact, viral-clip / multi-platform exports several minutes.

Supported formats#

• Video in: MP4, MOV, WebM (HTTP/HTTPS URLs, YouTube URLs, gallery IDs)
• Image in: JPG, PNG, WebP
• Audio in: MP3, WAV, M4A, AAC (or extracted from video)
• Output: MP4 (export), ZIP (viral clips / multi-platform bundles)
• Max video length: up to ~3 hours per asset (plan-dependent); sync edits and async handles longer
• Export caps: same as Studio billing — Free 720p with Levea watermark, Starter 1080p with no watermark, Creator / Studio / Enterprise 4K with no watermark
• Canvas resolution: 1080p or 4K recommended while editing; final export is capped by the active plan

Example: end-to-end viral-clip generation#

bash

# 1) Kick off the viral-clip pipeline (auto-export follow-up queues rendering)
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": "Generate 5 viral clips, 15-30 seconds each, on the most engaging moments. Add bold captions, vertical reframe, remove silences."
    },
    "project_id": "my-project"
  }' | tee /tmp/levea_result.json | jq -r '.jobId // .activeTasks[0].intent.job_id'

# 2) Poll until done
JOB_ID=$(jq -r '.jobId // .activeTasks[0].intent.job_id' /tmp/levea_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"
  { [ "$STATUS" = "completed" ] || [ "$STATUS" = "failed" ]; } && break
  sleep 5
done

# 3) Fetch the final artifact URL(s)
curl -sS "$LEVEA_API_URL/api/v1/misc/openclaw/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $LEVEA_API_KEY" | jq '.result'