T
transform-remove-background-with-transloadit
transform-remove-background-with-transloadit について
transform-remove-background-with-transloaditは、TransloaditのNode CLIでローカル画像の背景を削除するスキルです。steps.jsonの準備、認証情報の解決、透過PNGの保存方法を説明します。
主な機能
- 01ローカル画像を処理
- 02steps.jsonで背景除去を設定
- 03指定された場所から認証情報を取得
- 04透過PNGとして保存
- 05デバッグ時にassemblyの状態を確認
活用シーン
- 01画像素材の背景を削除
- 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のファイル名にならず、入力パスが維持される場合があります。- 前景の被写体がはっきりした写真を使用してください。背景除去の品質は元画像に左右されます。
コメント
Markdown 対応