白底图
阿里雲のビジュアルインテリジェンスオープンプラットフォームで画像を主体分割し、白背景画像、透明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— 透明背景 PNGcrop— 主体のバウンディングボックスに切り抜き
内部処理フロー(エラー時に参照)
- Pillow で画像の最長辺を確認し、2000px を超える場合は等比でリサイズ(阿里雲のハード制限 ≤ 2000×2000)
*AdvanceRequest.image_urlobject = open(...)でバイナリをアップロードclient.segment_xxx_advance(req, runtime)を呼び出しresp.body.data.image_urlは署名付き OSS CDN URL。urllib.request.urlretrieveでローカルにダウンロード- 出力ファイル名はソースファイルの stem をそのまま使い、拡張子は戻り値の形式に従う(mask→png、それ以外はソースと同じ)
注意事項
- 画像が 2000×2000 を超える場合、スクリプトは自動的にリサイズしますが、元の解像度は保持されません
- 透明背景(mask)出力の拡張子は .png、それ以外は入力の拡張子を引き継ぎます
- 資格情報はスクリプト内にハードコードされているのはプレースホルダーのみであり、本番環境では環境変数を使用することを推奨します
- 対応入力形式:PNG / JPG / JPEG / WebP / BMP
- ネットワーク:スクリプトは阿里雲から返された署名付き URL をダウンロードするため、マシンはインターネットにアクセス可能である必要があります