levea-mcp-server について
levea-mcp-serverは自然言語の指示をクラウドの動画制作バックエンドに渡し、AIエージェントが編集を計画・実行して書き出します。MCPクライアントで動画を扱う制作者向けで、実行前の計画承認も設定できます。
主な機能
- 01自然言語による複数工程の編集
- 02クリップ、字幕、リフレームの作成
- 03クロマキーとAI背景除去
- 04音声の整理、ナレーション追加、音楽ミックス
- 05プロジェクト、素材、字幕テンプレートの管理
- 06進捗ストリーミングと非同期ジョブ
活用シーン
- 01長尺ポッドキャストから字幕付き縦型クリップを作成
- 02SNS向けに複数のアスペクト比で書き出し
- 03背景を差し替えて話者を追跡
- 04実行前に編集計画を確認
MCP 対応
Claude、Cursor、Clineなどのクライアントに、動画編集とプロジェクト・素材・字幕テンプレート管理のツールを提供するMCPサーバーです。ホスト型の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)。ID は list_brand_kits で確認してください。プロジェクトのデフォルトブランドを上書きします。 |
| 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 | いいえ | 計画時にエージェントが考慮する Base64 エンコード済みの参照画像(任意)。 |
| projectBrandId | string | いいえ | プロジェクトのデフォルトブランド(任意)。永続化されます。呼び出し単位の brandId が優先されます。 |
| captionTemplateMode | enum | いいえ | captionTemplatePreset の適用方法。add | recreate | style | translate | clear | remove_fillers |
| requirePlanApproval | boolean | いいえ | true の場合、エージェントは計画後に停止し、変更を加えずに { 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 Server
自律型エージェント動画エディターです。 文章を送るだけで、完成した動画が手に入ります。タイムラインも、キーフレームも、プラグインチェーンも不要です。ローカルの AI エージェント(Claude、Cursor、Cline)を、クラウド GPU 動画制作ハーネスに接続するオープンソースの MCP クライアントです。
ベータ版です。 エージェントは間違えることがあります。公開または共有する前に、すべての出力をプレビューしてください。重要性の高い編集や取り消せない編集を行う場合は、
requirePlanApproval: trueを渡してください。エージェントは計画後に停止し、実行前に承認を待ちます。
目次
- クイックスタート — 60 秒で実行
- できること — 伝えるだけで、形にします
- 機能一覧 — ツールセットの全容
- 目標とブリーフ — 一文から詳細なクリエイティブブリーフまで
- API リファレンス — エンドポイント、リクエスト/レスポンス、ストリーミング、非同期処理
- 対象ユーザー · 従来のエディターとの比較 · 安全性 · 対応メディア
- リンクとチャンネル
クイックスタート
汎用的なインターフェースは、levea-mcp-server MCP サーバーです。1 つのサーバーで、すべての MCP クライアント(Claude Desktop、Claude Code、Cursor、Cline、OpenClaw、Hermes)に対応します。ツールのインターフェースもバックエンドの契約も共通なので、プラットフォームごとに差異が生じません。
1. API キーを取得する — livecore.ai に登録し、OpenClaw API キーを生成します。
2. MCP サーバーを追加する — すべての MCP クライアントで、同じ npx の行を使えます。
{
"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 本作成し、キャプションを追加して、縦向きにリフレームしてください。」 エージェントがツールを選び、プロンプトを作成します。エディターは計画 → 実行 → 書き出しの順に処理します。
クライアントごとの設定
| クライアント | 方法 |
|---|---|
| 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 の掲載ページ、その他すべてのインターフェースが、同じツール契約を共有しています。
2 つのホスト — 混同しないでください
| ホスト | 用途 |
|---|---|
| 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 に表示されるツール
編集用のエントリーポイントは 1 つです。それ以外はすべて、型付きの状態管理とポーリングです — インテグレーターは JWT と MCP を混在させることなく、1 つの API キーで完全な編集体験を構築できます。
| グループ | ツール |
|---|---|
| 編集(エントリーポイントは 1 つ、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 のような抜け道もありません。バックエンドのプランナーが専門家の役割を担います。編集用の操作を細分化すると、プランナーの判断を再確認するために LLM を呼び出すことが促され、複数ステップにわたる意図が失われます。状態管理ツール(ブランド/プロジェクト/アセット/キャプションテンプレートの CRUD)は編集ではないため、意図を細分化することはありません。インテグレーターに型付きのアクセスを提供するだけです。
→ エージェント連携の詳細(スキーマ、非同期処理の仕様、エラー処理、プランの承認)については、AGENTS.md をご覧ください。
できること
わかりやすく指示するだけで、エージェントが編集を計画し、仕上げます。
| 指示 | 実行内容 |
|---|---|
| 「キャプションと縦型リフレームを追加して、バズるクリップを5本作って」 | 最適な場面を選び、カット、キャプション追加、リフレームを行い、書き出します |
| 「2時間のポッドキャストから、60秒のハイライトを切り出して」 | 物語の山場を特定し、トリミングして、キャプション付きで仕上げます |
| 「TikTok向けにして」 | 縦型の9:16リフレーム+キャプション+無音部分の削除+強調効果を追加します |
| 「TikTok、Reels、Shorts、YouTube、Instagram向けに書き出して」 | 一度の処理で、すべてのアスペクト比に対応した一式を書き出します |
| 「グリーンスクリーンをビーチに置き換えて、話者は中央に配置して」 | 1回の呼び出しで、クロマキー合成+背景の合成+モーショントラッキングを行います |
| 「グリーンスクリーンなしで、背景を削除して」 | AI によるアルファマット処理で背景を削除します(あらゆる映像に対応) |
| 「グリーンスクリーンなしで、背景を街のスカイラインに置き換えて」 | AI マットで被写体をきれいに切り抜き、その後ろに新しい背景を合成します |
| 「無音部分とつなぎ言葉をすべて削除して、BGMを追加して」 | 音声トラックを整え、話し声に合わせて音量を下げたBGMを追加します |
| 「話している人に合わせて自動でズームして」 | 話者を検出し、話者を追うように動的にズームしてフレーミングします |
| 「キャプションを付けて、『launch』と言うたびに強調して」 | 自動キャプション+キーワードの強調(拡大/グロー/パルス)を行います |
| 「Alexが映っているクリップをすべて探して」 | 複数のアセットを横断して、顔の同一性を検索します |
| 「冒頭に、クローンした声でナレーションを追加して」 | 音声クローン+TTSオーバーレイ+自動ダッキングを行います |
| 「カラオケ風に単語をハイライトする、Hormoziスタイルのキャプションを付けて」 | 発話に合わせて同期する単語単位のカラオケキャプションを作成します。発話中の単語を塗りつぶし、下線を付けます |
| 「製品への言及部分にBロールを生成して」 | AI でBロールを生成し、適切なタイムスタンプに配置します |
| 「Netflixのドキュメンタリーのようにカラーグレーディングして」 | 映画風プリセットを使ってカラーグレーディングします |
| 「クライマックスをスローモーションにして、明かされる瞬間でフリーズして」 | 速度変更(スローモーション/早送り)+フリーズフレームを行います |
| 「縦型にリフレームして。ただし、画面下部のキャプションにはかぶせないで」 | キャプションに安全な9:16リフレームを行います(画面上のテキスト領域を検出し、それらを避けてリフレームします) |
| 「重要な統計値を抜き出して、グラフとしてアニメーション表示して」 | 文字起こしに基づくグラフ+統計値を強調するモーショングラフィックスを作成します |
| 「この3つのカメラアングルを同期して、話者に合わせて切り替えて」 | マルチカメラを同期し、アングルを自動で切り替えます |
| 「ナンバープレートをぼかして、罵り言葉をビープ音で消して」 | プライバシー保護のためのマスキング+不適切な言葉の除去を行います |
機能一覧
プロンプトの背後にあるすべてのツールです。以下の機能はすべて自然言語で利用でき、1つの文で自由に組み合わせられます。
🔍 読み取りと確認
- シーンの状態 — タイムライン/レイヤー/シーンの構造、スキーマの調査
- 検索 — アセットギャラリー(種類、長さ、名前)、文字起こし(キーワード、意味、タイムスタンプ)
- ビジョン — CV によるフレーム分析(オブジェクト、顔、シーン)、画面上のテキスト領域の検出(テロップ/画面下部の字幕/映像に焼き付けられたキャプションの位置を特定し、リフレーム時に重ならないようにします)
- インテリジェンス — 物語の山場、話者のダイアライゼーション、感情、テンポ
- ジョブ — 非同期ジョブのステータス確認
✂️ 構造編集
- レイヤー — 挿入/更新/置換/削除(ビデオ、オーディオ、画像、テキスト、図形、単色、調整、グループ、ライト、VFX、ビジュアライザー、Lottie)
- タイミング — トリミング、分割、速度変更(スローモーション 0.5×、早送り 2×、フリーズフレーム)、逆再生、手ぶれ補正
- 配置 — 再配置、並べ替え、文字起こしの単語境界にスナップ
- 組み立て — マルチカメラの同期+アングルの自動切り替え、モンタージュの組み立て(素材映像からショットを見つけて順番に配置)、スライドショーの生成、チャプターマーカー、SRT のインポート
- 安全性 — ギャップの補完、音量の正規化、長さの調整(書き出し前の処理)、複数ステップの元に戻す/やり直す
🎬 ビジュアル編集
- カラーグレーディング — 明るさ、コントラスト、彩度、色相、リフト/ガンマ/ゲイン、RGB カーブ、LUT/フィルムルックのプリセット、ビネット、色収差
- VFX シェーダー — 煙、ほこり、炎、爆発、稲妻、雪、グリッチ、走査線、グレイン、グラスモーフィズム、ボケ、溶岩、腐食、ポータル
- コンポジット — クロマキー、AI 背景除去(アルファマット)、マスキング(輝度/アルファ/深度、ブール演算による複数マスク対応)
- ブレンドと不透明度 — 17 種類のブレンドモード(乗算、スクリーン、オーバーレイ、覆い焼きカラー/焼き込みカラー、差の絶対値、色相/彩度/カラー/輝度、加算)+レイヤー単位およびグループ単位の不透明度
- シェイプと変形 — クリップシェイプ(円、ドーム、星、六角形、多角形)、クロップ、3D 回転/パース、グロー、シャドウ、グラデーション塗り
- ライティング — 最大 8 個のシーンライトで、3D 変形したレイヤーを照明
- リフレームとレイアウト — 字幕セーフ対応の縦型リフレーム(9:16)+縦型モンタージュ、分割画面(上下、左右、ピクチャーインピクチャー、グリッド)
- トラッキング — ズーム追従付きモーション/顔トラッキング、ブランディングオーバーレイ
📊 モーショングラフィックスとデータビジュアライゼーション
本番環境で使えるアニメーショングラフィックスを 30 種類以上搭載:
- データ — トランスクリプト連動のグラフ(棒、折れ線、円)、統計情報のコールアウト、アニメーション付きカウンター
- ローワーサードとカード — ローワーサード、タイトル/チャプターカード
- 図表 — フローチャート、タイムライン、地理情報のコールアウト
- CTA — アニメーション付き登録/行動喚起ボタン
💬 字幕とテキスト
- 生成 — トランスクリプトから字幕を自動生成
- スタイル — 組み込みテンプレート、または実行時に選択/生成する AI ディレクター
- アニメーション — 単語ごとのアニメーション(タイプライター、スライド、フェード、拡大縮小、回転、バウンス、フリップ、スイング、弾性、ぼかし、グリッチ、ウェーブ。各アニメーションに対応する退出効果付き)
- タイポグラフィ — 滑らかに拡大縮小できるグリフ(MSDF)、ストローク/アウトライン、ドロップシャドウ、グラデーション塗り、背景ピル/ボックス、単語ごとのカラオケ塗り+下線
- シェイプ — 曲線テキストパス(円、ウェーブ、カスタム SVG)、Lottie 再生制御
🎵 オーディオ
- クリーンアップ — 無音、息継ぎ、フィラー語を除去。単語単位のミュート/カット
- ミックス — オートダッキング(サイドチェーンで音楽を音声に対して調整)、ラウドネス(LUFS)のノーマライズ+トゥルーピークリミッター、ノイズ除去、クロスフェード、EQ プリセット(低音強調、ボーカル明瞭化、温かみ、明るさ)、ステム分離
- 生成 — 効果音、音楽(ムード/ジャンル/BPM)、ナレーション(TTS またはクローン音声)
- 同期 — 外部マスター音声との位置合わせ(タイムコード/明示的なオフセット)
- 可視化 — 波形(バー、波形、円形)
🔒 プライバシーとクリーンアップ
- 顔 — すべての顔または背景のみをぼかす
- 領域 — プライバシー保護のためのマスキング(ぼかし/覆い隠し)
- 言語 — 不適切な言葉をクリーンアップ(ミュート/ビープ音)
- レイアウト — セーフゾーンを修復
✨ 非同期生成
- 動画 — AI 動画/B ロール(長さ+アスペクト比)
- 画像 — AI 画像(タイムスタンプで単一または一括生成)、生成 AI による画像編集、サムネイルの自動抽出
- オーディオ — AI 音楽(プロンプト+長さ+ムード+ジャンル+BPM)、AI ナレーション(TTS またはクローン音声ライブラリ)
🚀 ハイレベルプリセット
- バイラル — 縦型+字幕+無音除去+トラッキング+単語の強調
- シネマティックディレクター — ダイナミックズーム+シネマティックグレーディング+ムードに合わせたカメラワーク
- 強調システム — キーワード検出+連動する拡大縮小/グロー/パルス
- ペーシング最適化 — 視聴維持のため、フィラー語+無音+低エネルギー部分を除去
📦 エクスポート
- MP4 — 単一ファイル(解像度/コーデック/品質レベル)
- バイラルクリップの一括出力 — 短尺動画を自動でセグメント化し、ZIP としてパッケージ化
- マルチプラットフォームパック — TikTok+Reels+Shorts+YouTube+Instagram 向けに一括出力
✅ そのほかの搭載機能
- コンテンツ認識型インペインティング(LaMa)—
REPLACE_ON_SCREEN_TEXTとオーバーレイ除去機能により、画面上のテキスト、ロゴ、ウォーターマークを除去 - 画面上のテキスト OCR 認識 — PP-OCRv5 による検出+認識で
TextRegion.textにテキストを設定し、映像に焼き込まれたテキストの検索と置換を可能にします
目標とブリーフ
autonomous_edit には、5語のコマンドから500語のクリエイティブブリーフまで、あらゆる内容を渡せます。
1. 直接コマンド — 1回の編集で1つの結果を得ます。上記の機能の例は、すべて直接コマンドです。
2. 自由形式の目標 — コマンドではなく目標をエージェントに渡します。エージェントはアセットを調査し、計画を提案します。
"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 と組み合わせると、提案のみのモードになります。エージェントは計画の作成後に停止し、承認を待ちます(計画の承認を参照)。
3. 詳細なクリエイティブブリーフ — 複数ステップのオーケストレーションをエンドツーエンドで実行します。エージェントはブリーフを標準アクションのDAGに分解し、順序を計画して、安全性のゲートを通じて実行し、各ステップを検証したうえで、指定されたすべての形式でエクスポートします。SSEを使うと、各ステップがリアルタイムで反映される様子を確認できます。
ブリーフの例(計画された1回の実行で約20個のアクションを組み合わせます)
この動画を、話題になるソーシャルメディア向けのドキュメンタリーに仕上げてください。まず、無音部分を除くため、冒頭3秒と末尾5秒をトリミングします。暖色系でコントラストを強めた、シネマティックなカラーグレーディングを適用します。太字の黄色い文字に黒い縁取りを付けた自動字幕を生成し、画面下部中央に配置します。冒頭10秒間、メインの被写体にダイナミックなズームインを適用します。話者が視覚的な概念に言及する箇所に、内容に合ったBロールクリップを3つ挿入します。TikTokとReels向けに縦型の9:16へ変換する際は、顔追跡を適用して被写体を中央に保ちます。動画の雰囲気に合ったアップテンポのBGMを追加し、話者が話すときは自動ダッキングを適用します。0.5秒を超える無音部分をすべて除去します。控えめなビネットを適用します。右上に、不透明度80%でロゴのウォーターマークを追加します。最も表情豊かなフレームを使い、太字の「MUST WATCH」の文字を入れたカスタムサムネイルを生成します。5秒の時点で表示され、脈打つようにアニメーションする登録ボタンを追加します。トランジションにウーシュ効果音を追加します。ノイズリダクションを適用します。30秒の位置で分割し、2秒のトランジションを挿入します。重要な統計情報に、アニメーション付きのカウンターオーバーレイを追加します。プライバシー保護のため、背景にいる人物の顔をぼかします。YouTube向けに1080pでエクスポートし、さらにプラットフォームごとのアスペクト比に合わせて最適化したTikTok、Reels、Shorts向けのバージョンも作成します。
タイムラインUIも、ステップごとのAPI呼び出しも、そちらで用意するグルーコードも不要です。
APIリファレンス
ベースURL:{LEVEA_API_URL}(本番環境:https://api.livecore.ai)。すべてのリクエストで認証が必要です。
Authorization: Bearer {LEVEA_API_KEY}
すべてのパスは /api/v1/misc/openclaw の下にあります。
| エンドポイント | 目的 |
|---|---|
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/ルートではありません。
リクエスト
すべての編集は、1つのツール autonomous_edit を通じて行います。自然言語で説明を渡すと、エージェントが計画、実行、検証、エクスポートを行います。覚えるツール一覧も、学ぶ必要のある構造化パラメーターもありません。
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 を指定します。正確な ID を確認するには、list_caption_templates を呼び出してください。 |
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 を渡すと、エージェントは計画後に停止します。status: "awaiting_approval" と、値が設定された workingMemory が返されます。承認を示すプロンプト(yes、approve、go、do it、confirm)とともに、同じ workingMemory を送信して再開します。
対象ユーザー
| 対象ユーザー | 得られるもの |
|---|---|
| クリエイター&インフルエンサー | 長尺動画 → TikTok/Reels/Shorts · 自動字幕 · バズるクリップの生成 · AI サムネイル |
| ポッドキャスター | ビデオポッドキャストのハイライト · オーディオグラム · マルチカム編集 · 無音部分とフィラー語の削除 |
| マーケター&代理店 | 大量の広告作成 · ソーシャル向けの再利用 · ブランドオーバーレイの自動化 · 複数プラットフォームへのエクスポート |
| 教育者&コース制作者 | チュートリアル編集 · 自動チャプター · タイトル/チャプターカード · 自動字幕 · 単語単位の強調 |
| YouTuber | 長尺動画 → Shorts のパイプライン · サムネイル生成 · イントロ/アウトロの自動化 · チャプターマーカー |
| 営業&SaaS | 製品デモ · 操作ガイドのハイライト · クローン音声によるナレーション |
| イベントチーム | ウェビナー/カンファレンスのハイライト · マルチカム映像の結合 · 登壇者に焦点を当てたリール |
| 信仰&コミュニティ | ソーシャル向けの説教クリップ · メッセージのハイライト · 複数プラットフォーム向けのパッケージ化 |
従来のエディターとの比較
| 従来型(Premiere、DaVinci、CapCut、Descript) | Levea MCP Server | |
|---|---|---|
| インターフェース | 手動でドラッグ&ドロップし、キーフレームを設定 | 1文指示するだけで、エージェントが残りを実行 |
| アップロード時の自動分析 | 手動でシーンを検出し、字幕を作成 | 顔、話者、ショット、画面上のテキスト領域、マットを自動検出 |
| 「これをバズらせて」 | ワークフローを自分で構築 | 1つのプリセットで対応 — 縦型化 + 字幕 + 無音部分 + トラッキング |
| アセット横断検索 | ファイル名で検索 | ライブラリ全体から「Alex が登場するクリップをすべて検索」 |
| 背景の置き換え | キーアウトし、背景を探して合成 | 1回の呼び出しで完了 |
| 放送品質のオーディオ | 手動でラウドネスを測定し、EQ を調整 | ラウドネスを自動で LUFS 正規化し、トゥルーピークを制限。音声の下で音楽を自動的にダッキング |
| 編集上の判断 | クライマックスを自分で判断 | エージェントが物語の山場やリアクションの瞬間を提示 |
| 検証 | 自分の目で確認 | 実行後に検証ツールが確認し、失敗時は自動修復 |
| 複数プラットフォームへのエクスポート | アスペクト比ごとに個別にレンダリング | 1回の処理で TikTok + Reels + Shorts + YouTube + Instagram |
| 拡張性 | プラグインから外部バイナリを呼び出す | 名前を指定して型付きツールを呼び出す |
これは AI 機能を後付けしたエディターではありません — 編集を最後まで仕上げてくれる、自律型エージェントです。
安全性と制限
- ベータ版 — 出力が誤っている場合があります。共有する前に、すべての結果をプレビューしてください。取り消せないワークフローでは、
requirePlanApproval: trueを渡して、最初にプランを確認して承認してください。 - すべてのリクエストで API キー認証が必要です。
- 破壊的な操作(一括削除、クリア)には、明示的な確認パラメーターが必要です。
- 実行後に出力を検証し、失敗時は自動修復します。
- 同一のリクエストが同時に実行された場合、サーバー側で重複排除されます。
- API キーごとにレート制限があります。読み取り専用は約 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。キャンバスはプロジェクトごとに設定可能 |
リンクとチャンネル
| チャンネル | 識別子/リンク |
|---|---|
| npm(MCP サーバー) | levea-mcp-server |
| MCP Registry | io.github.brajendrak00068/levea-mcp-server (レジストリ) |
| ClawHub プラグイン | openclaw-ai-video-editor |
| ClawHub スキル(エージェント型) | 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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。