mcpField
V
video-background-removal

video-background-removal

github.com/eachlabsクリエイティブ・メディア44232 回インストール今日更新
リポジトリ

video-background-removal について

each::sense を使って動画の背景を除去・置換する編集スキルです。合成素材、プレゼンテーション、通話、商品動画の制作に向け、透明・単色・画像・動画背景やぼかしに対応します。

主な機能

  1. 01背景を除去して透明化
  2. 02単色または画像への置換
  3. 03動画背景との合成
  4. 04背景ぼかしの適用
  5. 05eco または max モードの選択

活用シーン

  1. 01編集用の透明素材を作成
  2. 02バーチャルオフィスの会議動画を作成
  3. 03白背景の商品動画を制作
  4. 04話者映像にスタジオ背景を追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/eachlabs/skills --skill video-background-removal

インストール後、Claude Code で/video-background-removalを入力して読み込まれたか確認します。

同梱ファイルreferences/SSE-EVENTS.md

詳細

動画の背景除去

each::sense を使って、動画の背景を除去・置換します。このスキルを使うと、あらゆる動画コンテンツで透明な背景、バーチャル環境、プロ品質の合成、クリエイティブな背景エフェクトを実現できます。

機能

  • 透明な背景:合成用に背景を完全に除去します
  • 単色への置換:任意の単色(白、黒、ブランドカラー)に置き換えます
  • 画像背景:被写体を静止画像の背景に合成します
  • 動画背景:被写体を動きのある動画背景に配置します
  • バーチャルオフィス:リモートワーク用のプロフェッショナルな会議背景
  • グリーンバック効果:実際のグリーンバックなしでクロマキー合成を実現します
  • 背景のぼかし:ビデオ通話向けのプライバシーに配慮したぼかし効果
  • アニメーション背景:被写体の背後に動きのあるモーショングラフィックスを追加します
  • 商品動画:背景を除去・置換した、すっきりとした商品映像
  • トーキングヘッド動画:プレゼンター向けのプロフェッショナルな背景

クイックスタート

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background from this video and make it transparent"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/my-video.mp4"]
  }'

ユースケースの例

1. 動画の背景を除去(透明化)

動画編集ソフトで合成するために、背景が透明な動画を作成します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background from this video completely. Output should have a transparent background so I can composite it in my video editor. Keep the subject cleanly isolated with smooth edges."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/presenter-video.mp4"]
  }'
2. 単色に置換

プロ品質のコンテンツ向けに、背景をすっきりとした単色に置き換えます。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Replace the background of this video with a solid white background. Keep the subject sharp and well-isolated. Clean edges, professional look suitable for corporate presentations."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/interview-clip.mp4"]
  }'
3. 画像背景に置換

被写体を静止画像の背景に合成します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background from this video and replace it with the provided image. Blend the subject naturally into the new scene with appropriate lighting and shadows."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/person-talking.mp4"],
    "image_urls": ["https://example.com/beach-sunset-background.jpg"]
  }'
4. 動画背景に置換

動きのある動画背景を使って、ダイナミックな合成を作成します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background from my video and replace it with the second video as the new background. Sync the timing and make the composite look natural."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": [
      "https://example.com/foreground-subject.mp4",
      "https://example.com/cityscape-background.mp4"
    ]
  }'
5. バーチャルオフィスの背景

プロフェッショナルなバーチャル会議用背景を作成します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Replace the background with a professional modern office environment. Clean minimalist design with bookshelves, plants, and soft natural lighting. Suitable for executive video calls and professional meetings."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/webcam-recording.mp4"]
  }'
6. グリーンバックの置換(グリーンバックなし)

グリーンバックを使わず、あらゆる動画からクロマキー品質の結果を実現します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Extract the person from this video as if it was shot on a green screen. Clean matte extraction with no background spill. Output with transparent background or green screen color for post-production keying."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/filmed-at-home.mp4"]
  }'
7. 動画の背景をぼかす

ビデオ通話やコンテンツ向けに、プライバシーに配慮した背景のぼかしを適用します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Apply a smooth gaussian blur to the background while keeping the person in focus. Moderate blur intensity - enough to hide details but keep sense of depth. Natural bokeh effect like a portrait mode camera."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/home-office-call.mp4"]
  }'
8. アニメーション背景に置換

動きのあるモーショングラフィックスやアニメーション背景を追加します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background and replace it with an animated gradient background. Smooth flowing colors transitioning between blue and purple. Subtle movement, not distracting. Professional motion graphics style."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/content-creator.mp4"]
  }'
9. 商品動画の背景除去

ECサイトやマーケティング向けに、すっきりとした商品映像を作成します。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background from this product video. The product is a rotating sneaker on a turntable. Make the background pure white for e-commerce use. Maintain all product details, reflections, and shadows."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/product-360-spin.mp4"]
  }'
10. トーキングヘッド動画の背景を変更

プレゼンターやトーキングヘッド動画向けのプロフェッショナルな背景にします。

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Replace the background in this talking head video with a professional studio setting. Dark backdrop with subtle colored accent lighting like a podcast studio or news desk. Keep the presenter well-lit and naturally composited."}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/youtube-video.mp4"]
  }'

複数ターンのワークフロー例

session_id を使って、複数のリクエストにわたり背景の置換を調整します。

# Initial background removal
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove the background from this video of me presenting"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "bg-removal-project-001",
    "video_urls": ["https://example.com/presentation.mp4"]
  }'

# Iterate with different background
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Now replace it with a modern tech office background instead"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "bg-removal-project-001"
  }'

# Fine-tune the result
curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "The edges look a bit rough around my hair. Can you refine the matte for better edge quality?"}],
    "model": "eachsense/beta",
    "stream": true,
    "session_id": "bg-removal-project-001"
  }'

モードの選択

ニーズに応じて適切なモードを選択してください。

モード最適な用途速度品質
max最終版の動画、クライアントへの納品物遅い最高品質、最も優れたエッジ検出
ecoクイックプレビュー、コンセプトのテスト、下書き速い良好な品質、レビューに適しています

**推奨:**背景のテストには eco モードを、最終レンダリングには max モードを使用してください。

ベストプラクティス

きれいに切り抜くには
  • 照明:暗い映像より、十分に照明された被写体のほうがきれいに切り抜けます
  • コントラスト:被写体と背景のコントラストが高いほど効果的です
  • 動き:動きがゆっくりしているほど、きれいなマットを作成できます
  • 髪や細部:複雑な髪型の被写体には「エッジを調整」と指定します
自然な合成にするには
  • 照明を合わせる:映像の照明に合った背景を指定します
  • カラーグレーディング:被写体と背景の色を合わせるよう指定します
  • 影:合成に自然になじむ影の配置を指定します
  • 被写界深度:背景のぼけ具合をカメラの被写界深度に合わせます
プロフェッショナルな仕上がりにするには
  • ユースケース(企業、ソーシャルメディア、放送)を指定します
  • 出力要件(解像度、形式)を伝えます
  • ブランドに合った背景スタイルを指定します

プロンプトのヒント

背景の除去・置換を依頼する際は、以下を含めてください。

  1. 素材の説明:動画に何が映っているか(人物、商品など)
  2. 背景の目的:透明、単色、特定のシーン、ぼかし
  3. 品質要件:エッジの品質、影の処理、反射
  4. ユースケース:この動画をどこで使用するか
  5. スタイルの調整:照明、色調、雰囲気
プロンプト構造の例
"Remove/replace the background from this [subject type] video.
[New background description or transparent/solid color].
[Edge quality and compositing requirements].
For use in [context/platform]."

エラー処理

エラー原因解決策
Failed to create prediction: HTTP 422残高不足eachlabs.ai でチャージしてください
タイムアウト動画処理に時間がかかりますクライアントのタイムアウトを最低 10 分に設定してください
エッジの品質が低い髪の毛や細部が複雑プロンプトで「エッジ検出を精緻化」と指定してください
被写体の検出に失敗映像のコントラストが低いより明るい映像を試すか、被写体の位置を指定してください

タイムアウトの設定

動画の背景除去は計算負荷の高い処理です。HTTP クライアントのタイムアウトを適切に設定してください。

  • 推奨される最小タイムアウト:10 分(600 秒)
  • 長い動画の場合:動画 10 秒ごとにタイムアウトを 1 分ずつ延長してください
# Example with explicit timeout using curl
curl --max-time 600 -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -H "Accept: text/event-stream" \
  -d '{
    "messages": [{"role": "user", "content": "Remove background from this video"}],
    "model": "eachsense/beta",
    "stream": true,
    "mode": "max",
    "video_urls": ["https://example.com/long-video.mp4"]
  }'

関連スキル

  • each-sense - コア API ドキュメント
  • product-video-generation - E コマース動画の作成
  • video-generation - AI 動画生成
  • image-background-removal - 静止画像の背景除去

コメント