Let's Build: Transloadit で背景を除去
ローカルの商品写真やポートレートから背景を除去し、結果を PNG として保存します。このサンプルでは、画像を 1 枚 Transloadit にアップロードし、処理の完了を待ってから、結果を新しいローカルファイルにダウンロードします。
作成するもの
このコマンドは、空ではない 20 MiB 以下の PNG または JPEG ファイルを受け付けます。また、.png で終わる出力パスの明示的な指定が必要です。これらは、このチュートリアルの実行プログラムで設けた制限です。元のファイルは変更されません。保存した画像を確認してから、カタログやデザインに使用します。
背景除去には料金が発生します。既存の Transloadit Workspace の Auth Key と Auth Secret、およびアップロードの許可を得ている画像が必要です。AI プロバイダーの認証情報を別途用意する必要はありません。この処理設定では、プロバイダーの選択に Robot のデフォルトの自動選択を使用します。プログラムが認証情報を作成したり変更したりすることはありません。より多くのファイルで実行する前に、料金を確認してください。
パイプラインの概要
🤖 /image/bgremove Robot は、アップロードされた画像を受け取り、PNG を生成します。その後、実行プログラムが結果をローカルに保存するため、一時的な結果 URL を保持する必要はありません。
Local PNG or JPEG → upload → /image/bgremove → download → result.png
Assembly のスニペット
ダウンロード可能なプログラムは、処理設定を example としてエクスポートします。下記のプロジェクト構成で、この TypeScript コードを使うと、Assembly を送信せずに、コマンドが使用するものと同じ Assembly Instructions
を読み取れます。
import { example } from './background-remover/run.ts'
const steps = example.steps()
remove_background Step は :original を使用し、format: 'png' を設定して、result: true で出力を指定します。パイプラインを調整する場合は、ダウンロードした処理設定に変更を反映してください。これにより、コマンドとアプリケーションで同じ処理設定を使用できます。
サンプルアプリの実行
まず、Node.js 26、Corepack、cURL をインストールしてください。テストには Node.js 26.12.1 を使用しました。新規インストールでは、メンテナンスされている Node.js 26 のパッチバージョンを使用してください。Corepack は別途必要です。既存の Node プロジェクトの外に新しい空のディレクトリを作成し、そこでサンプルの READMEに従って、アプリのインストールとダウンロードを行ってください。サンプルでは、テスト済みの組み合わせとして Yarn 4.12.0、@transloadit/node 4.14.0、zod 3.25.76、zod-to-json-schema 3.25.2 に固定しています。最新のパッケージであると主張するものではありません。インストールコマンドは 1 つずつ実行し、いずれかが失敗した場合は中止してください。
README のコマンドで、background-remover/run.ts と shared/runtime.ts
の両方をダウンロードしてください。プログラムは ../shared/runtime.ts
をインポートするため、ファイルの相対的な配置が重要です。アクセスを設定する前に、README の
--help コマンドを実行してください。このコマンドに認証情報は不要です。サンプルを調整する場合は、生成されたロックファイルを保持してください。
同じシェルで、プレースホルダーをローカルで置き換え、既存の認証情報をエクスポートしてください。
export TRANSLOADIT_AUTH_KEY='YOUR_AUTH_KEY'
export TRANSLOADIT_AUTH_SECRET='YOUR_AUTH_SECRET'
Secret をバージョン管理やブラウザー側のコードに含めないでください。プログラムはこれらの環境変数を直接読み取ります。環境変数ファイルは読み込みません。
画像を input.jpg に配置するか、入力引数を画像のパスに置き換えてください。出力ファイル名には、まだ存在しない名前を選んでください。このコマンドを実行すると、課金対象の処理を承認したことになります。
node background-remover/run.ts --input ./input.jpg --output ./result.png
成功すると、ターミナルに Saved
と、それに続くローカルの出力パスが表示されます。result.png を透明部分を表示できる画像エディターで開くか、コントラストのある背景に重ねてください。背景が透明になり、被写体、輪郭、細部が使用に適した状態で残っていることを確認してください。Assembly の完了と PNG の有効性だけでは、切り抜きの仕上がりが良いとは判断できません。
実行プログラムは、Assembly の送信前に既存の出力先を拒否するため、再実行には新しい出力ファイル名が必要です。ダウンロードする結果は 20 MiB 以下に制限され、処理の待機時間は最大 5 分です。結果のダウンロードには、別途 30 秒のタイムアウトが設定されています。Assembly ID の表示後に実行が失敗した場合は、再試行する前に Console でその Assembly を確認してください。ローカルでのタイムアウトや中断は、リモート処理の停止を意味しません。また、失敗した処理にも料金が発生する場合があります。実行プログラムが Assembly を自動で再試行することはありません。
画像素材に適した入力
まずは、機密性のない、輪郭がはっきりした商品写真か、アップロードしてよいポートレートを使用してください。保存した PNG と元画像を同じ縮尺で比較します。髪、半透明の素材、影、背景に似た前景の物体は、注意深く確認する必要があります。必要な部分が切り抜きで失われる場合は、別の入力画像を選んでください。
次のステップ
切り抜き結果を確認したら、ダウンロードした処理設定に、リサイズやサムネイル作成の Step を追加できます。利用可能な背景除去オプションについては、Robot のドキュメントで説明しています。より大規模なアップロードワークフローを構築する前に、確認済みの結果としてローカルの PNG を保持してください。
