mcpField
I
image-remove-background

image-remove-background

github.com/agntswrmクリエイティブ・メディア6205 回インストール34 週間前に更新
リポジトリ

image-remove-background について

image-remove-background は、画像の背景を取り除き、被写体を透明背景で出力するコマンドラインスキルです。ローカル CPU 処理のほか、fal と replicate を利用できます。

主な機能

  1. 01被写体を残して背景を除去
  2. 02ローカルファイルや URL を入力
  3. 03local、fal、replicate の選択
  4. 04出力先パスの指定
  5. 05fal で出力解像度を指定

活用シーン

  1. 01ポートレートを透明背景に加工
  2. 02ローカルやオンラインの画像を処理
  3. 03fal で指定解像度の画像を処理

インストール

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

$npx skills add https://github.com/agntswrm/agent-media --skill image-remove-background

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

詳細

画像の背景を削除

画像の背景を削除し、前景の被写体だけを透明な状態で残します。

コマンド

npx agent-media@latest image remove-background --in <path> [options]

入力

オプション必須説明
--inはい入力ファイルのパスまたは URL
--outいいえ出力先のパス、ファイル名、またはディレクトリ（デフォルト：./）
--providerいいえ使用するプロバイダー（local、fal、replicate）
--resolutionいいえ出力解像度（例："2048x2048"）。fal Dynamic モデルでサポートされています。

出力

処理済み画像のパスを含む JSON オブジェクトを返します。

{
  "ok": true,
  "media_type": "image",
  "action": "remove-background",
  "provider": "fal",
  "output_path": "nobg_123_abc.png",
  "mime": "image/png",
  "bytes": 34567
}

例

ローカルファイルの背景を削除します：

npx agent-media@latest image remove-background --in portrait.jpg

特定のプロバイダーを使用して背景を削除します：

npx agent-media@latest image remove-background --in portrait.jpg --provider replicate

最大解像度で背景を削除します（fal Dynamic モデル）：

npx agent-media@latest image remove-background --in portrait.jpg --provider fal --resolution 2048x2048

プロバイダー

local

Transformers.js を使用して CPU 上でローカルに実行します。API キーは不要です。

  • Xenova/modnet モデルを使用します
  • モデルは初回使用時にダウンロードされます（約25MB）
  • mutex lock failed エラーが表示される場合がありますが、"ok": true であれば出力は正しいため、無視してください
npx agent-media@latest image remove-background --in portrait.jpg --provider local
fal
  • FAL_API_KEY が必要です
  • General Use (Dynamic) バリアントの birefnet/v2 モデルを使用します
  • 入力画像の最大解像度で処理するための --resolution オプション（例："2048x2048"）をサポートしています
replicate
  • REPLICATE_API_TOKEN が必要です
  • birefnet モデルを使用します

コメント

Markdown 対応