Fondo Blanco
Segmenta el sujeto principal de una imagen a través de la plataforma de inteligencia visual de Alibaba Cloud, generando un fondo blanco, PNG transparente o un recorte.
Comportamiento predeterminado: crea un subdirectorio fondo_blanco en el directorio de origen (o en el mismo directorio del archivo) para almacenar los resultados, se puede sobrescribir con -o.
Ubicación de salida predeterminada
| Entrada | Directorio de salida predeterminado |
|---|---|
Directorio ./fotos/ | ./fotos/fondo_blanco/ |
Archivo ./fotos/a.jpg | ./fotos/fondo_blanco/a.jpg |
Para enviar la salida a otra ubicación, usa -o /ruta/de/salida explícitamente.
Requisitos previos
pip install alibabacloud_imageseg20191230 alibabacloud_tea_openapi alibabacloud_tea_util Pillow
Configurar credenciales
Se priorizan las variables de entorno; si no están configuradas, se usan valores internos en el script (en producción, usa siempre variables de entorno):
setx ALIBABA_CLOUD_ACCESS_KEY_ID "TuKey"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "TuSecret"
Modo de uso
Ejecuta directamente scripts/aliyun_seg.py.
Procesamiento por lotes de directorios (salida predeterminada en directorio_origen/fondo_blanco)
python scripts/aliyun_seg.py ./fotos # Segmentación de productos + fondo blanco
python scripts/aliyun_seg.py ./fotos -m body # Segmentación de personas
python scripts/aliyun_seg.py ./fotos -f mask # PNG con fondo transparente
python scripts/aliyun_seg.py ./fotos -o ./salida -f crop # Recorta al área del sujeto, salida en ./salida
Imagen individual (salida predeterminada en mismo_directorio_del_archivo/fondo_blanco)
python scripts/aliyun_seg.py ./fotos/a.jpg # → ./fotos/fondo_blanco/a.jpg
python scripts/aliyun_seg.py ./fotos/a.jpg -o resultado.png # → ./resultado.png
Herramientas
python scripts/aliyun_seg.py --list-models # Enumera todos los modelos compatibles
Modelos compatibles
| Modelo | Descripción | Formato de retorno |
|---|---|---|
commodity | Segmentación de productos (recomendado para fondo blanco) | whiteBK / mask / crop |
common | Segmentación general | whiteBK / mask / crop |
body | Segmentación de personas | whiteBK / mask / crop |
food | Segmentación de alimentos | whiteBK / mask / crop |
animal | Segmentación de animales | whiteBK / mask / crop |
hd_common | Segmentación general en alta definición | Solo imagen segmentada |
cloth | Segmentación de ropa | Solo imagen segmentada |
logo | Segmentación de logotipos | Solo imagen segmentada |
vehicle | Segmentación de vehículos | Solo imagen segmentada |
sky | Segmentación de cielo | Solo imagen segmentada |
Formatos de retorno
whiteBK— Fondo blanco (predeterminado, el más usado)mask— PNG con fondo transparentecrop— Recorta al cuadro delimitador del sujeto
Flujo interno (útil en caso de errores)
- Pillow verifica el lado más largo de la imagen; si supera los 2000px, la escala proporcionalmente (límite estricto de Alibaba Cloud: ≤ 2000×2000)
- Sube el binario usando
*AdvanceRequest.image_urlobject = open(...) - Llama a
client.segment_xxx_advance(req, runtime) resp.body.data.image_urles una URL firmada de OSS CDN; se descarga conurllib.request.urlretrieve- El nombre del archivo de salida conserva el nombre original; la extensión depende del formato de retorno (mask→png, de lo contrario igual que la entrada)
Notas
- Las imágenes mayores de 2000×2000 se redimensionan automáticamente; la resolución original no se conserva
- La salida de fondo transparente (mask) tiene extensión .png; las demás conservan la extensión de entrada
- Las credenciales codificadas en el script son solo marcadores de posición; en producción se recomienda usar variables de entorno
- Formatos de entrada compatibles: PNG / JPG / JPEG / WebP / BMP
- Red: el script descarga la URL firmada devuelta por Alibaba Cloud; la máquina debe tener acceso a Internet público