Docs do Nodaro
DocumentaçãoReferência de nósModelosAgentes de IA (MCP)DesenvolvedoresSelf-hostingPesquisa
Imagem

Gerar máscara

Descreva um assunto em palavras simples, como “the red car”, e receba uma máscara em preto e branco dele para repintar só essa área em um nó de edição.

O nó Gerar máscara (Generate Mask) encontra um assunto em uma imagem a partir de uma descrição em texto e retorna uma máscara em preto e branco dele. Você escreve uma frase curta, como “the red car”, e o nó marca esse assunto em branco e todo o resto em preto. Conecte a máscara a um nó de edição para repintar só essa área.

Quando usar

Início rápido

Adicionar o nó

Pressione Tab no canvas e escolha Imagem › Edição e retoque › Gerar máscara.

Conectar a imagem

Arraste de um nó de imagem, como o Enviar imagem (Upload Image) ou o Gerar imagem (Generate Image), até a entrada Imagem.

Descrever o assunto

Abra o painel de configurações e escreva o assunto em Descreva o que mascarar, por exemplo the red car.

Executar e conectar a máscara

Clique em Executar. A máscara aparece no nó. Conecte a saída Máscara à entrada Máscara de um nó de edição, e a mesma imagem à entrada Imagem desse nó. No Modificar imagem, escolha um modelo que aceite máscaras, como o Ideogram Edit.

imagemimagem + máscaraEnviar imagemFoto de ruaGerar máscarathe red carModificar imagemIdeogram Edit
O Gerar máscara repassa a foto junto com uma máscara do carro vermelho, e o Modificar imagem repinta só essa área.

Entradas

EntradaAceitaO que faz
ImagemNós de imagem, como Enviar imagem, Gerar imagem e Modificar imagemA imagem em que o assunto é procurado. Obrigatória.

O Gerar máscara tem duas saídas:

SaídaO que leva
ImagemA imagem original, sem mudanças. Use-a para enviar a mesma imagem ao nó de edição junto com a máscara.
MáscaraUm PNG em preto e branco do tamanho da imagem. O branco é o assunto, a área a editar. O preto é todo o resto, a área a manter.

A máscara é um PNG comum, então também funciona em qualquer lugar que aceite uma imagem, por exemplo para visualizá-la ou para salvá-la.

Configurações

ConfiguraçãoO que faz
Descreva o que mascararO assunto a encontrar, como uma frase curta, por exemplo the red car, the woman ou the background. Obrigatória, com até 500 caracteres.
Limite de detecçãoUm controle deslizante de 0.05 a 0.95, com padrão 0.3. O modelo que o Gerar máscara usa hoje ignora esse valor, então mover o controle não muda a máscara. Para mudar o resultado, mude o prompt.
Texto antes e depoisTexto que é sempre adicionado antes e depois do prompt. Ele fica oculto para quem usa o seu workflow como app. Veja Texto antes e depois do prompt.

Como a máscara é feita

O Gerar máscara sempre usa um único modelo de segmentação, o Grounded SAM. O modelo encontra o assunto que as suas palavras nomeiam e depois traça o contorno exato dele. A versão do modelo é fixa, então a mesma imagem e o mesmo prompt sempre dão a mesma máscara. Não há um modelo para escolher.

Branco significa “editar”, e preto significa “manter”. O Pintar máscara e o pintor de máscara do Modificar imagem usam a mesma regra, então uma máscara gerada e uma máscara pintada são intercambiáveis.

Créditos

Toda execução custa 55 créditos, qualquer que seja o tamanho da imagem ou o prompt. Quando nenhuma região corresponde à descrição, a execução falha e os créditos são reembolsados.

Solução de problemas

A execução falha com “No region matched the mask prompt”. Nada na imagem correspondeu às suas palavras. Os seus créditos são reembolsados. Executar o mesmo prompt de novo falha do mesmo jeito, então reescreva-o como uma frase mais curta e mais simples, como the hat em vez de uma descrição longa.

A máscara está vazia. Uma máscara toda preta significa que o prompt era genérico demais ou que o assunto não está na imagem. Nomeie o assunto com mais clareza, por exemplo the left girl's hair em vez de hair.

A máscara está quase certa. Conecte a saída Máscara à entrada Máscara inicial de um nó Pintar máscara. O pintor dele abre com a máscara gerada, e você pode adicionar ou apagar áreas à mão.

Dicas

  • Nomeie um assunto claro. O modelo lê expressões nominais curtas, como the woman ou the red car, muito melhor do que orações longas.
  • Mantenha a imagem e a máscara juntas. A saída Imagem repassa a original, então uma conexão de cada saída chega ao nó de edição.
  • Não use o controle deslizante para corrigir uma máscara. O Limite de detecção não tem efeito hoje. Mude o prompt ou refine a máscara à mão.

Perguntas frequentes

Última atualização

Nesta página