# Sobreposição em imagem

> Posicione até 12 camadas, como logos, textos, QR codes e formas, em uma imagem, com precisão de pixel e prévia ao vivo. Exporte para várias plataformas.

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

O nó **Sobreposição em imagem** (Image Overlay) posiciona camadas sobre uma imagem base, exatamente onde você as coloca. Uma camada pode ser uma imagem, como um logo ou um recorte, um texto real em uma fonte incluída, um QR code ou uma forma simples. Nada é redesenhado por IA, então um elemento da marca sai igual ao arquivo que você forneceu. Use o nó para marcas d’água, logos, títulos, selos de preço e banners dimensionados para cada plataforma.

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

## Quando usar
- Aplique uma marca d’água ou a sua marca em todas as imagens geradas antes de publicá-las.
- Monte banners para YouTube, LinkedIn ou X e capas de vídeo com o arquivo real do seu logo sobre um fundo gerado por IA.
- Coloque um recorte do [**Remover fundo** (Remove Background)](https://nodaro.ai/docs/nodes/image/remove-background) sobre um novo fundo, com uma sombra.
- Adicione um selo ou um adesivo, como “NOVO”, uma etiqueta de preço ou uma avaliação, a fotos de produto.
- Coloque um QR code em um folheto, ou um código por produto em um lote.
- Monte cards de antes e depois ou cards de comparação a partir de dois resultados.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Imagem › Edição e retoque › Sobreposição em imagem**.

### Conectar a imagem base
Arraste da imagem de fundo, por exemplo um resultado do [**Gerar imagem** (Generate Image)](https://nodaro.ai/docs/nodes/image/generate-image), até a entrada **Base**. O nó passa a mostrar uma prévia ao vivo.

### Adicionar camadas
Conecte uma imagem, como um nó [**Enviar imagem** (Upload Image)](https://nodaro.ai/docs/nodes/image/upload-image) com o seu logo, à **Camada 1**. Para um texto, um QR code ou uma forma, clique em **Texto**, **QR** ou **Forma**. Essas camadas não precisam de conexão.

### Posicionar as camadas
Arraste uma camada na prévia para movê-la, puxe a alça do canto para redimensioná-la e puxe a alça de cima para girá-la. Você também pode digitar valores exatos no painel de configurações ou começar de uma **Predefinição**.

### Executar
A prévia é ao vivo, mas o arquivo só é gerado quando você executa. Clique em **Executar** no nó.

Workflow: O arquivo real do logo é colocado sobre uma imagem gerada; a saída principal vai para o Instagram, e a renderização do Cabeçalho do X / Twitter vai para o X, na mesma execução.

- Gerar imagem → Sobreposição em imagem (base)
- Enviar imagem → Sobreposição em imagem (camada 1)
- Sobreposição em imagem → Publicar no Instagram (imagem)
- Sobreposição em imagem → Publicar no X (cabeçalho do X / Twitter)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Base** | Nós de imagem ou uma Lista de URLs de imagens | A imagem sobre a qual tudo é posicionado. Obrigatória. Com uma Lista, o nó é executado uma vez por imagem, com as mesmas camadas. |
| **Camada 1** a **Camada 12** | Nós de imagem, como Enviar imagem, Remover fundo e Gerar imagem | Uma imagem por camada: um logo, um recorte, um adesivo. Camadas de texto, QR e forma não precisam de conexão. |
| **Link do QR** | Nós de texto, como **Texto** (Text), ou uma coluna de Lista | Só aparece quando uma camada de QR recebe o link do workflow. Com uma coluna de Lista, você recebe um código por linha. |

O nó mostra 4 entradas de camada no começo. Use **+ Camada** e **− Camada** para mostrar de 1 a 12, e a contagem também aumenta quando você conecta uma camada de número maior. Toda execução precisa de pelo menos uma camada: uma imagem conectada ou uma camada de texto, QR ou forma.

| Saída | O que leva |
| --- | --- |
| **Imagem** | A composição, em PNG por padrão. Ela mantém o tamanho em pixels da imagem base, a menos que você defina um tamanho de plataforma ou um tamanho de saída personalizado. |
| **Máscara** | Uma imagem em preto e branco do mesmo tamanho. O branco marca a área que uma edição com IA pode mudar. Veja [Saída de máscara](#mask-output). |
| Uma saída por plataforma | Para cada plataforma marcada em **Exportar também para**, uma saída com a renderização dessa plataforma, como Cabeçalho do X / Twitter. |

## Posicionar uma camada
Cada camada se prende à imagem base em uma âncora, e toda distância é uma porcentagem da imagem base.

| Configuração | O que faz |
| --- | --- |
| **Âncora** | Um de nove pontos da base: superior esquerdo, superior, superior direito, esquerda, centro, direita, inferior esquerdo, inferior ou inferior direito. O padrão é o centro. |
| **Deslocamento X** e **Deslocamento Y** | A distância a partir da âncora, de -100 a 100, em porcentagem da largura e da altura da base. Em uma âncora à direita ou embaixo, um deslocamento negativo move a camada para dentro. |
| **Largura** | A largura da camada em porcentagem da largura da base, de 1 a 100. O padrão é 25. A altura segue o formato da própria camada. |
| **Altura (% da base, opcional)** | Uma altura fixa em porcentagem da altura da base. Quando ela está definida, **Ajuste (quando a altura está definida)** decide como a camada preenche a caixa: **Ajustar**, **Preencher** ou **Esticar**. |
| **Opacidade** | De 0 a 100%. O padrão é 100%. |
| **Rotação** | De -180 a 180 graus, em torno do próprio centro da camada. |
| **Mesclagem** | **Normal**, **Multiplicação** ou **Tela**. |
| **Cantos arredondados (px)** | Arredonda os cantos da camada. |
| **Sombra projetada** | Uma cópia desfocada e tingida da camada, embaixo dela, com **Desfoque**, **Sombra X**, **Sombra Y**, **Cor da sombra** e **Opacidade da sombra**. |
| **Ordem das camadas (z)** | Números maiores são desenhados por cima. Vazio significa o número da camada, então a Camada 1 fica embaixo. Os botões de subir e de descer na prévia também definem esse valor. |

Por que porcentagens: o tamanho da imagem base é decidido em um nó anterior. Hoje ela pode ser uma renderização em 2K, e amanhã um pôster em 4K. Uma camada definida como “12% de largura, a 4% da borda direita” fica no mesmo lugar nas duas, e uma posição em pixels não ficaria. Depois que uma imagem base é conectada, o painel de configurações mostra o valor em pixels ao lado de cada porcentagem.

Uma camada que fica parcialmente fora da base é cortada na borda da base. Uma camada totalmente fora da base é ignorada, e isso não é um erro. Logos em SVG são desenhados no tamanho final em pixels, então continuam nítidos.

### Começar de uma predefinição
**Predefinição (preenche a camada 1)** configura a Camada 1 com um clique. Todos os valores continuam editáveis depois.

| Predefinição | Camada 1 |
| --- | --- |
| **Marca d’água (inferior direito)** | Inferior direito, 10% de largura, 85% de opacidade |
| **Logotipo (superior esquerdo)** | Superior esquerdo, 14% de largura |
| **Centralizado** | Centralizado, 40% de largura |
| **Borda a borda** | Cobre a base inteira |

### Exemplo: uma marca d’água
Conecte a foto à **Base** e o logo à **Camada 1** e, depois, defina estes valores na Camada 1:

| Configuração | Valor |
| --- | --- |
| **Âncora** | inferior direito |
| **Largura** | 12 |
| **Deslocamento X** | -4 |
| **Deslocamento Y** | -6 |
| **Opacidade** | 95% |

Em uma base de 2000 × 1000 pixels, o logo tem 240 pixels de largura. A borda direita dele fica a 80 pixels da direita, e a borda inferior, a 60 pixels de baixo. Em uma base de 4000 × 2000, todos esses números dobram, e o nó não precisa de nenhuma mudança.

## Tipos de camada
| Tipo | O que é | Como é dimensionada |
| --- | --- | --- |
| **Imagem** | Uma imagem conectada à entrada da camada: um logo, um recorte do Remover fundo, um adesivo | **Largura** em porcentagem da largura da base; a altura segue a imagem, a menos que **Altura** esteja definida |
| **Texto** | Texto real, desenhado com uma fonte incluída. A prévia usa o mesmo arquivo de fonte, então o resultado corresponde à prévia. | **Tamanho (% da altura da base)**; a caixa se ajusta ao texto |
| **QR** | Um QR code para um link ou para qualquer texto | **Largura** em porcentagem da largura da base; sempre quadrado |
| **Forma** | Retângulo, Retângulo arredondado, Pílula, Círculo, Faixa, Triângulo, Losango, Hexágono, Estrela, Selo de oferta ou Seta | **Largura** e **Altura** em porcentagem da base |

Para transformar uma camada de texto, QR ou forma de volta em uma camada de imagem, use **Reverter para espaço de imagem**.

### Camadas de texto
- **Fontes**: Inter, Montserrat, Space Grotesk, Playfair Display, Oswald, Bebas Neue, Anton, Pacifico, Rubik e Heebo. Rubik e Heebo compõem hebraico. As fontes variáveis aceitam qualquer **Peso** de 100 a 900.
- **Layout**: **Alinhamento**, **Espaçamento entre letras**, **Altura da linha** e **Maiúsculas**. O texto da direita para a esquerda é disposto da direita para a esquerda em cada linha.
- **Contorno**: um contorno em volta das letras, com **Espessura do contorno** e **Cor do contorno**.
- **Caixa de fundo (pílula / selo)**: uma caixa atrás do texto, com **Cor da caixa**, opacidade, **Margem interna** e um raio de canto. Um raio grande forma uma pílula.

### Camadas de imagem
Toda camada pode ter uma sombra projetada e cantos arredondados. Uma camada de imagem tem mais quatro acabamentos:

- **Recorte** corta a imagem em um círculo.
- **Suavização das bordas** esmaece as bordas ao longo de um número de pixels.
- **Contorno** desenha uma linha em volta da silhueta.
- **Brilho** adiciona um brilho colorido em volta dela.

### Camadas de QR
Digite o link em **Conteúdo do QR (URL ou texto)**. Você pode mudá-lo a qualquer momento, e o código é atualizado. **Cor do QR**, **Fundo do QR** e **Zona de silêncio** definem o visual.

Para pegar o link do workflow, ative **Usar saída do workflow**. O nó ganha uma entrada **Link do QR**: conecte a ela um nó Texto, uma coluna de Lista ou qualquer saída de texto. Com uma coluna de Lista, uma execução cria um código por linha, por exemplo cinquenta códigos para cinquenta páginas de produto. Uma execução com **Usar saída do workflow** ativado e nada conectado é recusada, com uma mensagem que cita a entrada.

## Tamanhos de plataforma e áreas seguras
**Tamanho da plataforma** transforma a saída no tamanho em pixels de uma plataforma:

| Plataforma | Tamanho em pixels |
| --- | --- |
| Miniatura do YouTube | 1280 x 720 |
| Banner do canal do YouTube | 2560 x 1440 |
| Capa de empresa do LinkedIn | 1128 x 191 |
| Capa pessoal do LinkedIn | 1584 x 396 |
| Cabeçalho do X / Twitter | 1500 x 500 |
| Capa de página do Facebook | 820 x 312 |
| Post do Instagram (1:1) | 1080 x 1080 |
| Post do Instagram (4:5) | 1080 x 1350 |
| Story do Instagram / TikTok (9:16) | 1080 x 1920 |
| Prévia de link (Open Graph) | 1200 x 630 |
| Slide de apresentação (16:9) | 1920 x 1080 |
| Impressão A4 @300dpi | 2480 x 3508 |

O padrão é **Manter o tamanho da imagem base**. Quando você escolhe uma plataforma, a prévia desenha a **área segura** dela como uma caixa tracejada: a parte que todo dispositivo mostra. Escolher uma plataforma também define **Ajuste da base** como **Preencher**, para que a imagem preencha o canvas. Para o Banner do canal do YouTube, a prévia mostra três zonas, uma dentro da outra: o que as TVs mostram, o que os computadores mostram e o que todos os dispositivos mostram.

Enquanto você arrasta, uma camada se encaixa nas linhas centrais, nas bordas e na área segura. Segure Shift para arrastar livremente.

**Exportar também para** renderiza a mesma composição em mais canvases de plataforma, na mesma execução. Marque quantas plataformas precisar, até as doze. Os arquivos extras aparecem como chips no resultado. Cada plataforma marcada também é uma saída no nó. Por exemplo, a renderização do Cabeçalho do X / Twitter pode alimentar um nó [**Publicar no X** (X Post)](https://nodaro.ai/docs/nodes/publish/x-post) enquanto a Capa de empresa do LinkedIn alimenta um nó [**Publicar no LinkedIn** (LinkedIn Post)](https://nodaro.ai/docs/nodes/publish/linkedin-post), na mesma execução. Cada plataforma extra aumenta o preço da execução, como explica a seção [Créditos](#credits).

**Abrir editor completo** abre uma visualização de edição grande do nó. O cabeçalho dela tem o mesmo menu de plataformas, e a área de trabalho vira o canvas dessa plataforma, com a área segura.

## Tamanho e formato da saída
| Configuração | O que faz |
| --- | --- |
| **Tamanho de saída personalizado** | Desativado por padrão: a saída mantém o tamanho em pixels da base. Ativado: a base é colocada em um canvas de **Largura do canvas (px)** × **Altura do canvas (px)**, com um **Fundo do canvas**. **Ajuste da base** decide como: **Ajustar** encaixa a base inteira e preenche o resto com a cor de fundo, e **Preencher** preenche o canvas e corta a base. As camadas continuam posicionadas em relação à base. |
| **Formato de saída** | **PNG (mantém a transparência)**, o padrão, **JPG** ou **WebP**. JPG e WebP removem a transparência. |

## Saída de máscara
A saída **Máscara** é uma imagem em preto e branco. O branco marca a área que uma edição com IA pode mudar. **Saída de máscara** escolhe o que fica branco:

| Opção | Área branca |
| --- | --- |
| **Anel em volta das camadas (para o acabamento com IA)** | Um anel em volta das camadas posicionadas, com a largura definida em **Largura do anel (px)**. Este é o padrão. |
| **As próprias camadas** | As camadas |
| **Tudo, exceto as camadas** | O resto da imagem |
| **Sem máscara** | Nada |

Conecte a máscara à entrada **Máscara** do [**Modificar imagem** (Modify Image)](https://nodaro.ai/docs/nodes/image/modify-image).

## Fazer parecer parte da imagem
O nó nunca redesenha as suas camadas. Esse é o objetivo, mas às vezes você quer que a cena reaja a elas: uma sombra de contato embaixo de um produto posicionado, uma luz combinando sobre um logo, um reflexo no chão.

Clique em **Adicionar acabamento com IA (para parecer parte da imagem)**. Ele adiciona um nó [Modificar imagem](https://nodaro.ai/docs/nodes/image/modify-image) depois deste. O novo nó é conectado à composição e ao anel de máscara em volta das suas camadas, e o prompt dele pede exatamente isso. O modelo só pode pintar dentro do anel, então ele adiciona sombras e luz em volta dos elementos. Todo pixel fora da máscara vem da composição, então os elementos continuam com precisão de pixel. Para orientar o visual, conecte um seletor [**Efeitos de composição** (Composition Effects)](https://nodaro.ai/docs/nodes/creative-controls/composition-effects) a esse nó Modificar imagem.

**Sugerir posição (IA)**, nas configurações de uma camada, pergunta a um modelo de visão onde a camada deve ficar. Ele evita rostos, o assunto principal e texturas carregadas, e fica dentro da área segura quando uma plataforma está definida. Depois, ele preenche a âncora e os deslocamentos. Custa o mesmo que uma execução do [**Descrever imagem** (Describe Image)](https://nodaro.ai/docs/nodes/image/describe-image), e você pode arrastar a camada depois, como sempre.

## Créditos
O Sobreposição em imagem custa 11 créditos pela composição e pela máscara dela, qualquer que seja o tamanho da imagem base ou o número de camadas. Cada plataforma extra em **Exportar também para** aumenta o preço.

O botão **Executar** mostra o preço exato antes da execução, e a estimativa do workflow e a API usam a mesma fórmula. O nó Modificar imagem que o **Adicionar acabamento com IA** cria é cobrado à parte, pelo preço do modelo dele.

## Dicas
- **Use arquivos transparentes.** Use um PNG transparente ou um SVG como camada. Um logo em JPG opaco é posicionado como um retângulo, então passe-o antes pelo [Remover fundo](https://nodaro.ai/docs/nodes/image/remove-background).
- **Mantenha os elementos da marca como arquivos.** Desenhe a imagem com um nó de IA e posicione aqui o logo real. Um modelo sempre redesenha um logotipo de texto com pequenos erros.
- **Integre as marcas à imagem.** Use **Multiplicação** para marcas escuras sobre fotos claras e **Tela** para marcas claras sobre fotos escuras.
- **Destaque um recorte.** Uma sombra projetada suave separa uma pessoa ou um produto de um fundo carregado. Experimente desfoque 24, **Sombra X** 0, **Sombra Y** 12 e opacidade de 50%.
- **Faça um banner a partir de uma renderização mais larga.** Ative **Tamanho de saída personalizado** com **Preencher**, por exemplo em 1500 × 500 pixels. O logo continua posicionado em relação à base, não ao canvas.
- **Gere a base primeiro.** Os valores em pixels ao lado de cada porcentagem aparecem quando uma imagem base de tamanho conhecido está conectada.
- **Gire e depois desloque.** A rotação gira a camada em torno do próprio centro. Adicione um deslocamento para manter uma marca girada bem junto de um canto.
- **Use camadas de texto para palavras e arquivos para logos.** Use uma camada de texto para títulos, legendas, preços e tarjas inferiores, e um arquivo SVG ou PNG para o logotipo da marca.

## Pela API
`POST /v1/image-overlay` recebe a imagem base e as camadas. Esta chamada posiciona a marca d’água do exemplo acima:

```json
{
"imageUrl": "https://example.com/photo.png",
"layers": [
{ "imageUrl": "https://example.com/logo.svg", "anchor": "bottom-right", "width": 12, "x": -4, "y": -6, "opacity": 0.95 }
]
}
```

- Uma camada de texto, QR ou forma define `layers[i].kind` como `text`, `qr` ou `shape`, com um objeto `text`, `qr` ou `shape`. `opacity` vai de 0 a 1, e `zIndex` define a ordem de empilhamento.
- `canvas` define um tamanho de plataforma ou um tamanho de saída personalizado. `outputFormat` é `png`, `jpg` ou `webp`.
- `variants`, por exemplo `["youtube-thumbnail", "x-header"]`, adiciona renderizações de plataforma. O resultado lista essas renderizações como `variants`, cada uma com `id`, `label`, `width`, `height` e `url`.
- `maskMode` é `around`, `layers`, `outside` ou `none`, e `maskSpread` é a largura do anel. A saída do job leva a máscara como `maskUrl`.
- Uma camada de QR com `qr.fromInput` definido como `true` pega o link de um `qrText` no nível superior.

## Frequently asked questions

### O “Sobreposição em imagem” usa IA?

Não. O “Sobreposição em imagem” posiciona as suas camadas exatamente como você definiu e não redesenha nada, então um logo sai igual ao arquivo que você forneceu. Só o acabamento com IA, que é opcional, e a sugestão de posição usam IA.

### Quantos créditos o “Sobreposição em imagem” custa?

11 créditos por execução, qualquer que seja o tamanho da imagem ou o número de camadas. Cada plataforma extra em “Exportar também para” aumenta o preço, e o nó mostra o preço exato antes da execução.

### Por que as posições das camadas são em porcentagem, e não em pixels?

As porcentagens mantêm o layout certo em qualquer tamanho de imagem. Um logo com 12% de largura, a 4% da borda direita, fica no mesmo lugar em uma prévia em 1K e em um pôster em 4K.

### Como adiciono uma marca d’água a muitas imagens de uma vez?

Conecte uma Lista de URLs de imagens à entrada “Base”. O nó é executado uma vez por imagem, com as mesmas camadas, então uma única execução pode aplicar a marca d’água a um lote inteiro.

### Como faço um produto posicionado parecer parte da cena?

Clique em “Adicionar acabamento com IA”. Ele adiciona um nó “Modificar imagem” que repinta só um anel em volta das suas camadas, com sombras de contato e luz combinando, enquanto as próprias camadas continuam com precisão de pixel.

### Quais fontes as camadas de texto podem usar?

Inter, Montserrat, Space Grotesk, Playfair Display, Oswald, Bebas Neue, Anton, Pacifico, Rubik e Heebo. Rubik e Heebo também compõem hebraico, e o texto da direita para a esquerda é disposto da direita para a esquerda.