mcpField
T
transform-remove-background-with-transloadit

transform-remove-background-with-transloadit

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

transform-remove-background-with-transloadit について

transform-remove-background-with-transloaditは、TransloaditのNode CLIでローカル画像の背景を削除するスキルです。steps.jsonの準備、認証情報の解決、透過PNGの保存方法を説明します。

主な機能

  1. 01ローカル画像を処理
  2. 02steps.jsonで背景除去を設定
  3. 03指定された場所から認証情報を取得
  4. 04透過PNGとして保存
  5. 05デバッグ時にassemblyの状態を確認

活用シーン

  1. 01画像素材の背景を削除
  2. 02背景透過PNGを作成

インストール

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

$npx skills add https://github.com/transloadit/skills --skill transform-remove-background-with-transloadit

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

詳細

入力

  • ローカル入力画像の絶対パス
  • 出力パス(任意)。指定しない場合は、同じディレクトリにある .png を明示的に指定します

準備手順

次の順序で認証情報を解決します。

  • シェル環境変数
  • 現在の作業ディレクトリの .env のみ
  • ~/.transloadit/credentials

.env が親ディレクトリにある場合は、先に変数をシェルにエクスポートしてください。

現在の作業ディレクトリに steps.json を作成します。

重要:

  • 現在の CLI では、--steps に渡すファイルは、ステップ名をキーとするフラットなオブジェクトである必要があります。
  • 最上位の "steps" キーでステップをラップしないでください。
{
  ":original": {
    "robot": "/upload/handle"
  },
  "background_removed": {
    "use": ":original",
    "robot": "/image/bgremove",
    "format": "png",
    "result": true
  }
}

実行(ローカル入力画像)

npx -y @transloadit/node assemblies create \
  --steps ./steps.json \
  -i ./input/source.jpg \
  -o ./out/result.png

必要に応じて、./input/source.jpg を実際の入力画像パスに置き換えてください。

コマンドの実行後、想定される出力パスに PNG が存在することを確認してください。

失敗した場合のデバッグ

npx -y @transloadit/node assemblies get <assemblyIdOrUrl> -j

注意:

  • ダウンロードした出力の透明度を維持するため、format: "png" のままにしてください。
  • ユーザーレベルで再利用可能な設定が必要な場合は、デフォルトのフォールバックとして ~/.transloadit/credentials を使用してください。
  • 現在のディレクトリの .env が引き続き優先されるため、アカウントを確実に選択する必要がある場合は使用しないでください。
  • リポジトリのルートにある .env に認証情報しかない場合は、そのディレクトリからコマンドを実行するか、先に変数をエクスポートしてください。
  • ./out/result.png のように、明示的な PNG ファイル名を指定してください。現在の CLI では、単一の結果にディレクトリを出力先として指定すると、.png のファイル名にならず、入力パスが維持される場合があります。
  • 前景の被写体がはっきりした写真を使用してください。背景除去の品質は元画像に左右されます。

コメント