🎬 ビデオスタジオ
システムにまだない3つの機能を追加します:埋め込み字幕の除去、チャンネル分析、再投稿パイプライン。残りのステージ(動画ダウンロード、字幕抽出、翻訳、TTS)は他の拡張機能に含まれています。以下のルールを参照してください。
🛑 重要ルール:ツールがない場合は、ユーザーを誘導し、「できません」と言わないこと
ほとんどのビデオステージはオプションの拡張機能で処理されます。ユーザーが拡張機能がインストールされていないことを要求した場合:
- 「その機能はありません」のような一般的な回答をしないでください。
{"action": "video_capabilities"}を発行して、正確なリストを取得します。- 結果をそのままユーザーに渡します。どの拡張機能をインストールすべきか、それぞれの説明、およびマーケット(
/market) に移動してからサーバーを再起動するよう促す情報が含まれています。
ジョブ → 必要な拡張機能:
| ジョブ | 必要な拡張機能 |
|---|---|
| 動画のダウンロード | video_downloader |
| 字幕の抽出・翻訳・焼き付け | subtitle_extractor |
| ナレーション(TTS) | tts_vibevoice |
| 元字幕の除去・チャンネル分析・パイプライン | video_studio(すでにインストール済み) |
| 完全な再投稿パイプライン | 上記4つすべて |
📥 video_capabilities — 何ができるかを確認する
{"action": "video_capabilities"}
動画リクエストを拒否する前に使用してください。
📥 analyze_channel — チャンネルを分析し、コンテンツを提案する
{"action": "analyze_channel", "url": "https://www.youtube.com/@tenkenh"}
トピック、視聴者層、トーン、ヒット動画のタイトル構成、および5~8個の新しい動画アイデア(フック付き)を返します。ユーザーが「このチャンネルは何についてのものか」「次にどんな動画を作るべきか」と尋ねたときに使用します。
📥 remove_hardsub — 埋め込み字幕を除去する
{"action": "remove_hardsub", "video_path": "C:/path/video.mp4", "mode": "delogo"}
mode: delogo(デフォルト — 周囲の境界から補間します。無地の背景ではテキストが消え、跡が残りません)、blur、pixel、fill。
📥 reup_video — 全チェーンを実行する
{"action": "reup_video", "url": "https://v.douyin.com/xxxx"}
ダウンロード → 字幕抽出 → 翻訳 → 元字幕をマスク → ナレーション → 新しい字幕を焼き付け。承認待ちのCodexタスクを作成します。タスク番号をユーザーに報告し、approve <n> を実行するよう促してください。実行が完了したとは言わないでください。キューに入れられただけです。
🌐 HTTP API
| メソッド | エンドポイント | ジョブ |
|---|---|---|
| GET | /api/v1/video-studio/capabilities | 何ができるか・何が不足しているか |
| GET | /api/v1/video-studio/capabilities/{job} | 1つのジョブの詳細 |
| POST | /api/v1/video-studio/hardsub/detect | 字幕領域の検出のみ、動画は変更しない |
| POST | /api/v1/video-studio/hardsub/remove | 検出+マスキング |
| POST | /api/v1/video-studio/channel/analyze | チャンネルの分析 |
| POST | /api/v1/video-studio/pipeline/plan | パイプラインが実行するステップの確認 |
| POST | /api/v1/video-studio/pipeline/reup | パイプラインをCodexタスクとしてキューに追加 |
💡 使用例
ユーザー: 「https://www.youtube.com/@abc このチャンネルはどんな内容ですか?」
{"action": "analyze_channel", "url": "https://www.youtube.com/@abc"}
ユーザー: 「この動画をベトナム語にリアップして https://v.douyin.com/xxx」
{"action": "reup_video", "url": "https://v.douyin.com/xxx"}
ユーザー: 「この動画から字幕を抽出して」— ただし subtitle_extractor がインストールされていない場合:
{"action": "video_capabilities"}
→ 結果をそのままユーザーに渡し、何をインストールすべきか知らせます。