Skip to main content
Geração e edição de imagens

Image erase and inpaint

Este recurso apaga uma área específica da imagem e preserva o plano de fundo. Forneça a imagem original, uma máscara da área a apagar e uma máscara da área a manter.

  • Este documento aplica-se apenas à região Continente chinês (Beijing). Para usar o modelo, utilize uma chave de API da região Continente chinês (Beijing).
  • O modelo image-erase-completion está disponível atualmente apenas para avaliação gratuita. Após o consumo da cota gratuita, não é mais possível chamar o modelo, e não há opções pagas compatíveis. Para alternativas, consulte Edição de imagens - Qwen ou Edição de imagens - Wan 2.1.

Introdução

A remoção e o preenchimento de imagens eliminam elementos como pessoas, animais de estimação, objetos, texto ou marcas d'água, mantendo o plano de fundo intacto. Especifique as áreas a remover por meio de uma máscara de imagem. Este recurso não oferece suporte a remoções baseadas em prompts de texto. A tecnologia utiliza técnicas avançadas, como preenchimento por Conteúdo Gerado por IA (AIGC), e aplica-se a diversos cenários, incluindo proteção de privacidade, criação de conteúdo e edição de imagens. Para remover pessoas, use a operação de API Segmentação de instância de pessoa. Selecione a área completa da máscara correspondente a cada indivíduo a remover. Essa operação gera com precisão uma máscara no nível de pixel para o contorno de cada objeto.

Cenários

  • Proteção de privacidade: Ao compartilhar fotos em redes sociais, pode ser necessário ocultar certas pessoas ou informações sensíveis, como indivíduos específicos, endereços ou números de telefone. O recurso de remoção e preenchimento elimina rapidamente esses elementos e evita vazamento de dados pessoais.
  • Imagens de produtos para e-commerce: Na exibição de produtos em plataformas de comércio eletrônico, frequentemente é preciso remover marcas d'água, logotipos ou outros elementos indesejados. A ferramenta identifica e apaga esses itens, tornando as imagens mais limpas e profissionais, o que melhora a experiência do usuário.
  • Marketing e publicidade: Durante a criação de anúncios, muitas vezes combina-se imagens de produtos com cenas ou pessoas específicas, mas a foto original pode conter elementos distrativos. Esta funcionalidade remove facilmente tais interferências visuais e aumenta a criatividade visual de pôsteres e peças publicitárias.
  • Conteúdo para redes sociais: Se você deseja eliminar transeuntes ou fundos desorganizados ao publicar fotos, a remoção e o preenchimento via IA facilitam esse processo e aprimoram significativamente a qualidade e a estética das suas imagens.

Recursos e vantagens

  • A tecnologia de IA preenche inteligentemente os espaços vazios deixados pelos elementos removidos. Isso garante que a imagem restaurada pareça natural e contínua, mantendo a harmonia visual e um aspecto profissional, sem vestígios de edição artificial.
  • O recurso detecta e remove automaticamente objetos de vários tamanhos em imagens de múltiplos formatos com alta precisão. Assegura-se assim uma remoção exata e um preenchimento consistente com aparência natural.
  • O serviço de plataforma de nível empresarial garante respostas estáveis na geração de imagens sob alta concorrência e tráfego intenso, com 99,9% de confiabilidade. Oferece uma operação de API de inferência simples, fácil de usar, integrar e altamente compatível.

Primeiros passos

Para obter melhores resultados, garanta que a máscara da área a manter esteja limpa e não contenha nenhum objeto a apagar. Ao obter a imagem de máscara a partir da segmentação de instância de pessoa, defina parameters.dilate_flag=true. Isso expande a área da máscara para evitar falhas nas bordas da região-alvo e cria uma máscara clara e completa.
  • Área a apagar (mask_url): Na imagem de máscara, configure os valores de pixel da área a apagar com um valor diferente de zero (não preto puro). Defina os valores de pixel de todas as outras áreas como zero (preto puro).
  • Área a manter (foreground_url): Na imagem de máscara, configure os valores de pixel da área a preservar com um valor diferente de zero (não preto puro). Defina os valores de pixel de todas as outras áreas como zero (preto puro).
Limites de entrada de imagem:
  • Resolução da imagem: O comprimento de cada lado deve estar entre 512 e 4.096 pixels.
  • Formato da imagem: JPEG, PNG, JPG, BMP ou WEBP.
  • Tamanho da imagem: Até 10 MB.
  • URLs não podem conter caracteres chineses.

Imagem original (image_url)

Máscara de segmentação de instância de pessoa

Área a apagar (mask_url)

Área a manter (foreground_url)

Saída

Image erasure - Original image

image

Image erasure - Erase result

Image erasure - Preserved areas

image

O modelo exige tempo de computação prolongado. O código de exemplo demonstra como fazer chamadas assíncronas para evitar tempos limite de requisição. Obter uma chave de API e exportar a chave de API como variável de ambiente.
  • curl
1. Crie uma tarefa de remoção e preenchimento de imagemA operação de API retorna um ID de tarefa. Use esse ID para consultar o resultado da geração de imagem.
curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--header 'X-DashScope-DataInspection: enable' \
--data-raw '{
    "model": "image-erase-completion",
    "input": {
            "image_url": "https://huarong123.oss-cn-hangzhou.aliyuncs.com/image/%E5%9B%BE%E7%89%87%E6%93%A6%E9%99%A42-%E5%8E%9F%E5%9B%BE.png",
            "mask_url": "https://huarong123.oss-cn-hangzhou.aliyuncs.com/image/%E5%9B%BE%E7%89%87%E6%93%A6%E9%99%A42-%E6%93%A6%E9%99%A4.png",
            "foreground_url": "https://huarong123.oss-cn-hangzhou.aliyuncs.com/image/%E5%9B%BE%E7%89%87%E6%93%A6%E9%99%A42-%E4%BF%9D%E7%95%99.png"
        },
    "parameters":{
        "dilate_flag":true
    }
}'
2. Consultar o status e o resultado da tarefa pelo ID da tarefa
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/13b1848b-5493-4c0e-8c44-xxxxxxxxxxxx \
     -H "Authorization: Bearer $DASHSCOPE_API_KEY" \

Exemplos

O fast_mode é adequado para cenários que não exigem alto nível de detalhe. Para mais informações, consulte Remoção e preenchimento de imagens.

Preservar detalhes da imagem (padrão, fast_mode=false)

{
  "model": "image-erase-completion",
  "input": {
    "image_url": "http://xxx/image.jpg",
    "mask_url": "http://xxx/mask.png",
    "foreground_url": "http://xxx/foreground.png"
  },
  "parameters":{
    "dilate_flag":true
  }
}

Imagem original (image_url)

Máscara de segmentação de instância de pessoa

Área a apagar (mask_url)

Área a manter (foreground_url)

Imagem de saída

image

image

image

image

image

image

image

image

image

image

image

image

image

image

image

image

image

image

image

image

Ignorar detalhes da imagem (fast_mode=true)

{
  "model": "image-erase-completion",
  "input": {
    "image_url": "http://xxx/image.jpg",
    "mask_url": "http://xxx/mask.png"
  },
  "parameters":{
    "fast_mode":true
  }
}

Imagem original (image_url)

Máscara da área a apagar (mask_url)

Imagem de saída

image

image

image

image

image

image

Referência da API

Para informações sobre os parâmetros de entrada e resposta da API, consulte Remoção e preenchimento de imagens.
Plano de Tokens
Playground de Modelos
Inferência do Modelo
Avaliação
Compressão de Modelos
Estatísticas e Monitoramento
Suporte