O que 白底图 faz?
Através da plataforma de inteligência visual da Alibaba Cloud, realiza a segmentação do assunto principal de imagens, gerando resultado com fundo branco, PNG transparente ou recorte.
Comportamento padrão: cria um subdiretório 白底图 no diretório de origem (ou no mesmo diretório do arquivo) para armazenar os resultados; use -o para sobrescrever.
Local de saída padrão
| Entrada | Diretório de saída padrão |
|---|---|
Diretório ./photos/ | ./photos/白底图/ |
Arquivo ./photos/a.jpg | ./photos/白底图/a.jpg |
Para enviar para outro local, use -o /path/to/out explicitamente.
Pré-requisitos
pip install alibabacloud_imageseg20191230 alibabacloud_tea_openapi alibabacloud_tea_util Pillow
Configuração de credenciais
Priorize variáveis de ambiente; se não definidas, o script usa placeholders embutidos (em produção, use variáveis de ambiente):
setx ALIBABA_CLOUD_ACCESS_KEY_ID "sua Key"
setx ALIBABA_CLOUD_ACCESS_KEY_SECRET "seu Secret"
Como usar
Execute diretamente scripts/aliyun_seg.py.
Lote em diretório (saída padrão para diretório_origem/白底图)
python scripts/aliyun_seg.py ./photos # Segmentação de commodity + fundo branco
python scripts/aliyun_seg.py ./photos -m body # Segmentação de corpo humano
python scripts/aliyun_seg.py ./photos -f mask # PNG com fundo transparente
python scripts/aliyun_seg.py ./photos -o ./out -f crop # Recortar para a região do assunto, saída para ./out
Imagem única (saída padrão para mesmo_diretório_do_arquivo/白底图)
python scripts/aliyun_seg.py ./photos/a.jpg # → ./photos/白底图/a.jpg
python scripts/aliyun_seg.py ./photos/a.jpg -o resultado.png # → ./resultado.png
Ferramentas
python scripts/aliyun_seg.py --list-models # Listar todos os modelos suportados
Modelos suportados
| Modelo | Descrição | Formato de retorno |
|---|---|---|
commodity | Segmentação de commodity (preferido para fundo branco) | whiteBK / mask / crop |
common | Segmentação genérica | whiteBK / mask / crop |
body | Segmentação de corpo humano | whiteBK / mask / crop |
food | Segmentação de alimentos | whiteBK / mask / crop |
animal | Segmentação de animais | whiteBK / mask / crop |
hd_common | Segmentação HD genérica | Apenas imagem segmentada |
cloth | Segmentação de roupas | Apenas imagem segmentada |
logo | Segmentação de logotipo | Apenas imagem segmentada |
vehicle | Segmentação de veículos | Apenas imagem segmentada |
sky | Segmentação de céu | Apenas imagem segmentada |
Formatos de retorno
whiteBK— Fundo branco (padrão, mais comum)mask— PNG com fundo transparentecrop— Recortar para a caixa delimitadora do assunto
Fluxo interno (consulte em caso de erro)
- Pillow verifica o lado mais longo da imagem; se ultrapassar 2000px, redimensiona proporcionalmente (limite rígido da Alibaba: ≤ 2000×2000)
- Usa
*AdvanceRequest.image_urlobject = open(...)para enviar o binário - Chama
client.segment_xxx_advance(req, runtime) resp.body.data.image_urlé uma URL OSS CDN assinada, baixada comurllib.request.urlretrieve- O nome do arquivo de saída mantém o stem do arquivo original; extensão varia conforme formato de retorno (mask → png, caso contrário igual ao original)
Observações
- Imagens maiores que 2000×2000 são redimensionadas automaticamente; a resolução original não é preservada
- A saída com fundo transparente (mask) tem extensão .png; as demais mantêm a extensão de entrada
- As credenciais embutidas no script são apenas placeholders; em produção, use variáveis de ambiente
- Suporta entrada PNG / JPG / JPEG / WebP / BMP
- Rede: o script faz download da URL assinada retornada pela Alibaba; a máquina precisa ter acesso à Internet pública