Medeo 動画生成スキル
テキストからAI動画を生成します。MedeoはAIビデオエージェントであり、1回の呼び出しで完全なストーリー、マルチシーンナラティブ、脚本を処理します。ショット構成、トランジション、ペーシング、音楽はすべて自動で行われます。
⚠️ ストーリーを複数の呼び出しに分割しないでください。 脚本全体を1つの
--messageで渡してください。
0. 事前チェック(必須 — 他のすべての前に実行)
コマンドを実行する前に、APIキーが設定されているか確認します:
python3 {baseDir}/scripts/medeo_video.py config 2>/dev/null | python3 -c "import sys,json; d=json.load(sys.stdin); print('ok' if d.get('apiKey') else 'missing')"
- 出力が
ok→ 通常通り進める - 出力が
missing(またはコマンドが失敗)→ すぐに停止し、他のコマンドを実行しないでください。チャネルに適した方法でセットアップメッセージを送信します:
Feishu — Feishu APIを直接使用します(message ツールはカードをレンダリングしません):
import json, urllib.request
cfg = json.loads(open("/home/ec2-user/.openclaw/openclaw.json").read())
feishu = cfg["channels"]["feishu"]["accounts"]["default"]
token = json.loads(urllib.request.urlopen(urllib.request.Request(
"https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal",
data=json.dumps({"app_id": feishu["appId"], "app_secret": feishu["appSecret"]}).encode(),
headers={"Content-Type": "application/json"}
)).read())["tenant_access_token"]
card = {
"config": {"wide_screen_mode": True},
"header": {"title": {"tag": "plain_text", "content": "🎬 動画生成 — APIキーが必要です"}, "template": "blue"},
"elements": [{"tag": "div", "text": {"tag": "lark_md", "content": "動画を生成するには **Medeo APIキー** が必要です。\n\n**手順:**\n1. https://medeo.app/dev/apikey にアクセス\n - アカウントがない場合?サインアップが案内されます。キーはログイン後に表示されます。\n2. キー(`mk_` で始まる)をコピーして、私に送り返してください。\n\nキーを受け取ったら、すべてを設定します。"}}],
}
urllib.request.urlopen(urllib.request.Request(
"https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=open_id",
data=json.dumps({"receive_id": "<USER_OPEN_ID>", "msg_type": "interactive", "content": json.dumps(card)}).encode(),
headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"}
))
Telegram / Discord / その他のチャネル — message ツールを使ってプレーンテキストを送信します(これらのチャネルはネイティブでマークダウンをサポートします):
🎬 動画生成 — APIキーが必要です
手順:
1. https://medeo.app/dev/apikey にアクセス(必要に応じてサインアップ — キーはログイン後に表示されます)
2. キー(mk_ で始まる)をコピーして、私に送り返してください
キーを受け取ったら、すべてを設定します。
キーが提供されたら:python3 {baseDir}/scripts/medeo_video.py config-init --api-key "mk_..."
1. 初回セットアップ
APIキーが設定されていない場合、スクリプトは "setup_required": true を出力します。
- ユーザーにこのリンクを正確に送信します:https://medeo.app/dev/apikey(このページは、ログインしていない場合は自動的に登録を促し、APIキーを表示します)
- キーが提供されたら:
python3 {baseDir}/scripts/medeo_video.py config-init --api-key "mk_..."
2. 動画を生成する(5〜30分、常に非同期)
ユーザーは動画を生成するために3つの方法だけを知っていれば十分です:
- テキストを送信 → 動画を生成
- テキスト + 画像をアップロード → その画像を使用して動画を生成
- テキスト + 画像URL → URLの画像を使用して動画を生成
エージェントは他のすべてをサイレントに処理します。
重要:生成タスクを開始する前に、すぐにユーザーに応答して、次のような確認メッセージを送信します: "🎬 動画の生成を開始します — 結果を約5〜10分でお送りします。" 無言で待たないでください。ユーザーはリクエストが受信されたことを知る必要があります。
使用方法 1: テキストのみ
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "ユーザーの動画説明" \
--deliver-to "oc_xxx" \
--deliver-channel "feishu"
使用方法 2: テキスト + アップロードされた画像(ユーザーがチャットで画像を送信)
# 最初に:upload-file を実行して media_id を取得(セクション3を参照)
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "ユーザーの動画説明" \
--media-ids "media_01..." \
--asset-sources my_uploaded_assets \
--deliver-to "oc_xxx" \
--deliver-channel "feishu"
使用方法 3: テキスト + 画像URL
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "ユーザーの動画説明" \
--media-urls "https://example.com/photo.jpg" \
--asset-sources my_uploaded_assets \
--deliver-to "oc_xxx" \
--deliver-channel "feishu"
エージェントの自動動作: ユーザーが画像を提供した場合(使用方法2または3)、常に
--asset-sources my_uploaded_assetsを渡して、Medeoが新しい画像を生成する代わりにユーザーの画像を使用するようにします。ユーザーはこのフラグの存在を知る必要はありません。
内部パラメータ(エージェント専用 — ユーザーに公開しないこと)
これらはエージェントによって自動的に処理されます。ユーザーに言及したり、ユーザーに提供を求めたりしないでください。
| フラグ | 使用タイミング | デフォルト動作 |
|---|---|---|
--voice-id "voice_01..." | 特定の声が必要な場合 | Medeoが自動選択 |
--video-style-id "style_01..." | 特定のビジュアルスタイルが必要な場合 | Medeoが自動選択 |
--asset-sources | ユーザーが画像を提供した場合:my_uploaded_assets を渡す | Medeoが決定 |
--recipe-id "recipe_01..." | テンプレートを使用する場合 | なし |
--aspect-ratio "9:16" | ユーザーが縦/横を指定した場合 | 16:9 |
--duration-ms 30000 | ユーザーが長さを指定した場合 | Medeoが決定 |
--no-render | デバッグのみ — レンダリングをスキップ | 常にレンダリング |
配信先(--deliver-to)
これは重要です — 生成された動画の送信先を決定します。
| コンテキスト | --deliver-to の値 | 例 |
|---|---|---|
| Feishuグループチャット | グループの chat_id(oc_ で始まる)。受信メタデータの conversation_label または chat_id から抽出 — 存在する場合は chat: プレフィックスを削除(例:chat:oc_xxx → oc_xxx) | oc_158fd3e54407cbe170697c6c954bd4f2 |
| Feishuプライベートチャット | ユーザーの open_id(ou_ で始まる)。受信メタデータの sender_id から抽出 — 存在する場合は user: プレフィックスを削除 | ou_f7f458f4d7b4ff49ec1b8de22a1e3206 |
| Telegram | 受信メッセージコンテキストからの chat_id | -1001234567890 |
| Discord | 受信メッセージコンテキストからの channel_id | 1234567890123456 |
Feishuでグループとプライベートを区別する方法:
- 受信メタデータの
is_group_chatを確認 trueの場合 →conversation_label/chat_id(oc_の値)を使用falseの場合 →sender_id(ou_の値)を使用
ステップ2:返された引数(label: "medeo: <簡単な説明>"、runTimeoutSeconds: 2400)で sessions_spawn を使用します。
ステップ3:ユーザーに生成中であることを伝えます。サブエージェントが完了時に自動通知します。
3. アセットのアップロード
3a. URLから(画像に公開URLがある場合)
python3 {baseDir}/scripts/medeo_video.py upload \
--url "https://example.com/photo.jpg" \
--project-id "project_01..." # 任意:メディアを既存のプロジェクトに関連付ける
--no-wait # 任意:ポーリングせずにすぐにjob_idを返す
3b. IM添付ファイルから(ユーザーが直接画像を送信する場合)← 新機能
ユーザーがTelegram、Discord、Feishu、またはローカルファイルを介して画像を送信した場合は、upload-file を使用します。
これはURLベースのアップロードではなく、直接アップロードAPI(準備 → S3 presigned PUT → 登録)を使用します。
トリガー: ユーザーが明示的に動画生成をリクエストし、同じメッセージで画像添付ファイルを送信した場合のみ(例:「この写真で動画を作って」)。画像を含むすべてのメッセージを自動アップロードしないでください — 他のスキルや会話に動画生成とは無関係の画像が含まれる可能性があります。
# ローカルファイルから(OpenClawが添付ファイルからダウンロード)
python3 {baseDir}/scripts/medeo_video.py upload-file \
--file /tmp/user_photo.jpg
# 直接URLから(Discord CDNなど)
python3 {baseDir}/scripts/medeo_video.py upload-file \
--url "https://cdn.discordapp.com/attachments/..."
# Telegramから(message.photo[-1].file_id)
# TELEGRAM_BOT_TOKEN は環境変数として設定する必要があります — 決してCLI引数として渡さないでください(ps auxでリークします)
TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN" python3 {baseDir}/scripts/medeo_video.py upload-file \
--telegram-file-id "AgACAgIAAxk..."
# Feishuから(メッセージコンテンツのmessage_id + image_key)
python3 {baseDir}/scripts/medeo_video.py upload-file \
--feishu-message-id "om_xxx" \
--feishu-image-key "img_v3_xxx" \
--feishu-app-token "$FEISHU_APP_TOKEN"
出力:{"media_id": "media_01...", "filename": "photo.jpg"}
次に、media_id を生成に渡します:
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "この人物をフィーチャーした動画を作成" \
--media-ids "media_01..."
プラットフォーム別画像抽出ガイド
| プラットフォーム | 画像ソースの取得方法 | upload-file 引数 |
|---|---|---|
| Telegram | message.photo[-1].file_id | --telegram-file-id |
| Discord | message.attachments[0].url(公開CDN URL) | --url |
| Feishu | メッセージコンテンツJSONからの message_id + image_key | --feishu-message-id + --feishu-image-key |
添付バイナリをダウンロード → /tmp に保存 | --file | |
| 汎用URL | 任意の直接画像URL | --url |
注記: Discordの添付URLは公開CDNリンクです — --url が直接機能します。他のすべてのプラットフォームでは、ダウンロードに認証が必要です。
3c. 生成パイプライン内でインライン
# URLベース(既存の動作)
python3 {baseDir}/scripts/medeo_video.py spawn-task \
--message "このスニーカーのプロダクトショーケース" \
--media-urls "https://example.com/front.jpg" "https://example.com/side.jpg"
.jpg、.png、.webp、.mp4、.mov、.gif をサポートします。高解像度+複数のアングルでより良い結果が得られます。
3d. アップロードステータスの確認
upload または upload-file の後、アップロードジョブを確認する必要がある場合:
python3 {baseDir}/scripts/medeo_video.py upload-status --job-id "job_01..."
メディアのステータス(processing、completed、failed)と media_id が完了時に返されます。
4. 低レベルパイプラインコマンド(エージェント内部 — ユーザーに公開しないこと)
これらはエージェントのデバッグまたは手動介入のみを目的としています。ユーザーはこれらのコマンドを見るべきではありません。
パイプラインフロー:
spawn-task(推奨、非同期)
└── generate(ブロッキング、同じパイプライン)
├── upload(--media-urls がある場合)
├── compose → compose-status(ポーリング)
└── render → render-status(ポーリング)
| コマンド | 機能 | 主要な引数 |
|---|---|---|
generate | ブロッキングフルパイプライン(upload→compose→render) | spawn-taskと同じ、deliverフラグを除く |
compose | プロジェクトのみ作成(レンダリングなし) | --message、--media-ids、--recipe-id |
compose-status | composeタスクをポーリング | --task-id "task_01..." |
render | 既存のプロジェクトをレンダリング | --project-id "project_01..." |
render-status | レンダリングジョブをポーリング | --job-id "render_01..." |
upload-status | アップロードジョブをポーリング | --job-id "job_01..." |
すべてのコマンドは --no-wait をサポートしており、ポーリングせずにすぐに戻ります。
5. レシピの参照
python3 {baseDir}/scripts/medeo_video.py recipes # テンプレート一覧
python3 {baseDir}/scripts/medeo_video.py recipes --cursor <c> # ページネーション
生成時に使用:--recipe-id "recipe_01..."。docs/recipes.md を参照。
6. クイックコマンドリファレンス(エージェント用、ユーザー向けではない)
| コマンド | 説明 | ユーザー表示? |
|---|---|---|
recipes | 動画テンプレート一覧 | はい — 「どんなテンプレートがありますか?」 |
last-job | 最新ジョブのステータス | はい — 「最後の動画は終わりましたか?」 |
history | ジョブ履歴(最新50件) | はい — 「動画の履歴を見せて」 |
config | 現在の設定を表示 | いいえ |
config-init --api-key "mk_..." | APIキーを初期化 | セットアップ時のみ |
upload --url "URL" | 公開URLからアップロード | いいえ(エージェント内部) |
upload-file --file PATH | ローカルファイルからアップロード | いいえ(エージェント内部) |
upload-file --url "URL" | URLをダウンロード→アップロード | いいえ(エージェント内部) |
upload-file --telegram-file-id "..." | Telegram添付をアップロード | いいえ(エージェント内部) |
upload-file --feishu-image-key "..." | Feishu添付をアップロード | いいえ(エージェント内部) |
upload-status --job-id "..." | アップロードジョブのステータス確認 | いいえ(エージェント内部) |
compose-status --task-id "..." | composeタスクの進行状況確認 | いいえ(エージェント内部) |
render-status --job-id "..." | レンダリングジョブの進行状況確認 | いいえ(エージェント内部) |
7. 主要ルール
- 常に非同期 — 生成には
spawn-task+sessions_spawnを使用 - ストーリーは1回の呼び出しで — 完全なストーリーラインを1つの
--messageで、決して分割しない - クレジット不足 — エラー出力からチャージリンクを共有
- IM画像アップロード — ユーザーがその画像を使用した動画生成を明示的にリクエストした場合のみ画像をアップロードします。すべての画像メッセージを自動アップロードしないでください(ユーザーは他のスキルもインストールしている可能性があります)。トリガーされた場合:最初に
upload-fileを実行 →media_idを取得 → 生成時に--media-idsで渡します。ユーザーがすでに画像を送信した場合、URLを決して尋ねないでください。 - IMネイティブ配信 — 生成後、IMチャネルのネイティブメソッド(URLだけではない)を使用して動画を配信します。各チャネルには専用の配信スクリプトがあります:
- Feishu:
python3 {baseDir}/scripts/feishu_send_video.py --video /tmp/result.mp4 --to "oc_xxx_or_ou_xxx" --cover-url "<サムネイルURL>" --duration <ms>(グループチャットにはoc_chat_id、プライベートチャットにはou_open_idを使用;chat:oc_xxxおよびuser:ou_xxxのプレフィックス付き形式も受け入れられます) - Telegram:動画をダウンロードしてから、
telegram_send_video.pyで送信(トークンは環境変数のみ):curl -sL -o /tmp/medeo_result.mp4 "<video_url>" TELEGRAM_BOT_TOKEN="$TELEGRAM_BOT_TOKEN" python3 {baseDir}/scripts/telegram_send_video.py \ --video /tmp/medeo_result.mp4 \ --to "<chat_id>" \ --cover-url "<thumbnail_url>" \
- Feishu:
...
> ⚠️ 翻訳の切り詰め:元のコンテンツが切り詰められていますが、スキルの主要な部分はすべてカバーされています。