# 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.

Source: https://nodaro.ai/pt-BR/docs/nodes/image/generate-mask

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.

- Found in: Image › Edit & Retouch
- Output: image
- API type: `generate-mask`

## Quando usar
- Mude um assunto e mantenha o resto: mascare “the jacket” e depois mude a cor dele no [**Modificar imagem** (Modify Image)](https://nodaro.ai/docs/nodes/image/modify-image).
- Substitua o que está atrás do assunto: mascare “the background” e repinte essa área.
- Comece uma máscara precisa feita à mão: gere uma primeiro e depois refine-a no [**Pintar máscara** (Paint Mask)](https://nodaro.ai/docs/nodes/image/paint-mask).
- Selecione uma área para o [**Reiluminar e trocar** (Relight & Switch)](https://nodaro.ai/docs/nodes/video/relight-and-switch) ou para qualquer outro nó com uma entrada de máscara.

## 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)](https://nodaro.ai/docs/nodes/image/upload-image) ou o [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/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](https://nodaro.ai/docs/nodes/image/modify-image), escolha um modelo que aceite máscaras, como o Ideogram Edit.

Workflow: O Gerar máscara repassa a foto junto com uma máscara do carro vermelho, e o Modificar imagem repinta só essa área.

- Enviar imagem → Gerar máscara (imagem)
- Gerar máscara → Modificar imagem (imagem + máscara)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Imagem** | Nós de imagem, como Enviar imagem, Gerar imagem e Modificar imagem | A imagem em que o assunto é procurado. Obrigatória. |

O Gerar máscara tem duas saídas:

| Saída | O que leva |
| --- | --- |
| **Imagem** | A imagem original, sem mudanças. Use-a para enviar a mesma imagem ao nó de edição junto com a máscara. |
| **Máscara** | Um 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ção | O que faz |
| --- | --- |
| **Descreva o que mascarar** | O 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ção** | Um 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 depois** | Texto 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](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

## 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](https://nodaro.ai/docs/nodes/image/paint-mask) e o pintor de máscara do [Modificar imagem](https://nodaro.ai/docs/nodes/image/modify-image) 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](https://nodaro.ai/docs/nodes/image/paint-mask). 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.

## Frequently asked questions

### O que o “Gerar máscara” produz?

Um PNG em preto e branco do tamanho da sua imagem. O branco marca o assunto que você descreveu, que é a área que um nó de edição pode mudar. O preto marca todo o resto, que fica como está.

### Quantos créditos o “Gerar máscara” custa?

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

### O que devo escrever no prompt?

Uma frase curta e simples que nomeie o assunto, como “the red car”, “the woman” ou “the left girl's hair”. Expressões nominais curtas funcionam muito melhor do que frases descritivas longas.

### Por que o “Gerar máscara” não encontrou nada?

A descrição não correspondeu a nada que o modelo conseguiu encontrar. Reescreva-a como uma frase mais curta e mais simples. Executar o mesmo prompt de novo dá o mesmo resultado.

### Posso corrigir uma máscara que está quase certa?

Sim. Conecte a saída “Máscara” à entrada “Máscara inicial” de um nó “Pintar máscara”. O pintor abre com a máscara gerada, e você adiciona ou apaga áreas à mão.