Communitygithub.com

白底图

透過阿里雲視覺智能開放平台對圖片進行主體分割,輸出白底圖、透明 PNG 或裁切圖。

白底图 是什麼?

這個 AI Agent 技能(名稱為「白底圖」)利用阿里雲視覺智能開放平台(Alibaba Cloud Visual Intelligence Open Platform)的影像分割 API,對圖片進行主體分割,並輸出白底圖、透明背景 PNG 或裁切圖。它支援多種分割模型,包括商品、通用、人體、食品、動物、高清通用、服飾、Logo、車輛及天空分割。技能提供批次目錄處理及單張圖片處理兩種模式,預設會在來源目錄(或來源檔案同目錄)下建立「白底圖」子目錄存放結果,也可透過 -o 參數自訂輸出位置。該技能適用於 Claude Code、Cursor 等支援 Python 腳本執行的 AI Agent 平台,開發者需先安裝 alibabacloud_imageseg、Pillow 等相依套件,並設定阿里雲 API 金鑰(建議使用環境變數)。內部流程會自動縮放超過 2000×2000 的圖片以符合 API 限制,並透過 OSS CDN 簽章 URL 下載結果。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add 490437477-sys/codex-skills-backup

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

白底圖

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

相關技能