흰색 배경 이미지
Alibaba Cloud Vision Intelligence Platform을 통해 이미지의 주요 객체를 분할하고 흰색 배경 이미지, 투명 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 "your-key"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "your-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 | HD 일반 분할 | 분할 결과 이미지만 |
cloth | 의류 분할 | 분할 결과 이미지만 |
logo | 로고 분할 | 분할 결과 이미지만 |
vehicle | 차량 분할 | 분할 결과 이미지만 |
sky | 하늘 분할 | 분할 결과 이미지만 |
반환 형식
whiteBK— 흰색 배경 (기본값, 가장 일반적)mask— 투명 배경 PNGcrop— 객체 경계 상자로 크롭
내부 흐름 (오류 발생 시 참고)
- Pillow로 이미지의 가장 긴 변을 확인하여 2000px를 초과하면 비율을 유지하며 축소합니다 (Alibaba Cloud의 하드 제한 ≤ 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×2000px를 초과하면 스크립트가 자동으로 축소하며 원본 해상도는 유지되지 않습니다.
- 투명 배경(mask) 출력의 확장자는 .png이며, 그 외에는 입력 확장자를 따릅니다.
- 자격 증명이 스크립트에 하드코딩되어 있는 것은 자리 표시자이며, 프로덕션 환경에서는 환경 변수를 사용하는 것이 좋습니다.
- PNG / JPG / JPEG / WebP / BMP 입력을 지원합니다.
- 네트워크: 스크립트가 Alibaba Cloud가 반환한 서명된 URL을 다운로드하므로, 머신이 공용 네트워크에 접근 가능해야 합니다.