白底圖
透過阿里雲視覺智能開放平台對圖片進行主體分割,輸出白底圖、透明 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 | 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,機器需能存取公網