Communitygithub.com

白底图 (背景除去・画像分割)

阿里雲のビジュアルインテリジェンスオープンプラットフォームを使用して画像の主体分割を行い、白背景画像、透明PNG、または切り抜き画像を出力します。

白底图 (背景除去・画像分割) とは?

このスキルは、阿里雲(Alibaba Cloud)の画像分割API(imageseg)を活用して、商品、人体、食品、動物、ロゴなど様々な対象を画像から分離し、白背景画像、透明PNG、または被写体のみを切り抜いた画像を生成します。開発者はコマンドラインからパスとモデル、出力形式を指定するだけで、複数の画像を一括処理できます。デフォルトでは入力ディレクトリ内に `白底图` フォルダを作成して結果を保存し、`-o` オプションで保存先を変更可能です。対応プラットフォームはAlibaba Cloud Aliyun Imageseg SDKを利用するため、Pythonが動作する任意の環境(Linux、macOS、Windows)で使用できます。内部ではPillowで画像サイズを確認し、2000pxを超える場合は自動的にリサイズした後、阿里雲APIにバイナリをアップロードし、返却された署名付きURLから結果をダウンロードします。

対応~Claude Code✓Codex CLI~Cursor
npx skills add 490437477-sys/codex-skills-backup

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

白底图

阿里雲のビジュアルインテリジェンスオープンプラットフォームで画像を主体分割し、白背景画像、透明PNG、または切り抜き画像を出力します。
デフォルト動作:ソースディレクトリ(またはソースファイルと同じディレクトリ)に 白底图 サブディレクトリを作成して結果を保存し、-o で上書きできます。

デフォルトの出力場所

入力デフォルトの出力ディレクトリ
ディレクトリ ./photos/./photos/白底图/
ファイル ./photos/a.jpg./photos/白底图/a.jpg

他の場所に出力するには、-o /path/to/out を明示的に指定します。

前提条件

pip install alibabacloud_imageseg20191230 alibabacloud_tea_openapi alibabacloud_tea_util Pillow

資格情報の設定

環境変数を優先して使用し、設定されていない場合はスクリプト内のプレースホルダーを使用します(本番環境では必ず環境変数に変更してください):

setx ALIBABA_CLOUD_ACCESS_KEY_ID "あなたのKey"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "あなたのSecret"

使用方法

scripts/aliyun_seg.py を直接実行します。

ディレクトリ一括処理(デフォルトで ソースディレクトリ/白底图 に出力)

python scripts/aliyun_seg.py ./photos                      # 一括商品分割 + 白背景画像
python scripts/aliyun_seg.py ./photos -m body              # 人体分割
python scripts/aliyun_seg.py ./photos -f mask              # 透明背景 PNG
python scripts/aliyun_seg.py ./photos -o ./out -f crop     # 主体領域に切り抜き、 ./out に出力

単一画像(デフォルトで ソースファイルと同じディレクトリ/白底图 に出力)

python scripts/aliyun_seg.py ./photos/a.jpg                # → ./photos/白底图/a.jpg
python scripts/aliyun_seg.py ./photos/a.jpg -o result.png  # → ./result.png

ツール

python scripts/aliyun_seg.py --list-models                 # サポートされているモデルを一覧表示

サポートされているモデル

モデル説明戻り値の形式
commodity商品分割(白背景に最適)whiteBK / mask / crop
common汎用分割whiteBK / mask / crop
body人体分割whiteBK / mask / crop
food食品分割whiteBK / mask / crop
animal動物分割whiteBK / mask / crop
hd_common高精細汎用分割分割結果画像のみ
cloth衣服分割分割結果画像のみ
logoロゴ分割分割結果画像のみ
vehicle車両分割分割結果画像のみ
sky空分割分割結果画像のみ

戻り値の形式

  • whiteBK — 白背景(デフォルト、最も一般的)
  • mask — 透明背景 PNG
  • crop — 主体のバウンディングボックスに切り抜き

内部処理フロー(エラー時に参照)

  1. Pillow で画像の最長辺を確認し、2000px を超える場合は等比でリサイズ(阿里雲のハード制限 ≤ 2000×2000)
  2. *AdvanceRequest.image_urlobject = open(...) でバイナリをアップロード
  3. client.segment_xxx_advance(req, runtime) を呼び出し
  4. resp.body.data.image_url は署名付き OSS CDN URL。urllib.request.urlretrieve でローカルにダウンロード
  5. 出力ファイル名はソースファイルの stem をそのまま使い、拡張子は戻り値の形式に従う(mask→png、それ以外はソースと同じ)

注意事項

  • 画像が 2000×2000 を超える場合、スクリプトは自動的にリサイズしますが、元の解像度は保持されません
  • 透明背景(mask)出力の拡張子は .png、それ以外は入力の拡張子を引き継ぎます
  • 資格情報はスクリプト内にハードコードされているのはプレースホルダーのみであり、本番環境では環境変数を使用することを推奨します
  • 対応入力形式:PNG / JPG / JPEG / WebP / BMP
  • ネットワーク:スクリプトは阿里雲から返された署名付き URL をダウンロードするため、マシンはインターネットにアクセス可能である必要があります

関連スキル