# Sobreposição em vídeo

> Mostre até 20 imagens em um vídeo, cada uma no seu intervalo: cartão, selo no canto, quadro inteiro ou caixa própria, com prévia ao vivo e áudio mantido.

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

O nó **Sobreposição em vídeo** (Video Overlay) mostra imagens sobre um vídeo, cada uma durante o próprio intervalo de tempo. Use-o para logos, fotos de produtos, capturas de tela e cartões sincronizados com uma narração. O nó desenha os seus arquivos de imagem exatos sobre o vídeo, mantém o áudio original e mostra uma prévia ao vivo no nó, tudo sem um modelo de IA.

- Found in: Video › Titles, Graphics & Captions
- API type: `video-overlay`

## Quando usar
- Você faz um anúncio UGC e quer que cartões de produto, capturas de tela de apps ou páginas da web apareçam enquanto a pessoa fala deles.
- Você quer um logo ou o @ de um canal na tela durante o vídeo inteiro.
- Você quer imagens fixas em picture-in-picture, imagens de antes e depois ou imagens de reação.
- Você quer etiquetas de preço ou selos de “NOVO” sobre clipes de produtos.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Títulos, gráficos e legendas › Sobreposição em vídeo**.

### Conectar o vídeo e as imagens
Conecte o vídeo de base à entrada **Vídeo**. Conecte cada imagem ao próprio conector de camada: **Camada 1**, **Camada 2** e assim por diante. O nó começa com 4 conectores de camada.

### Definir o tempo e a posição de cada camada
Abra o painel de configurações. Para cada camada, defina **Início (s)** e **Fim (s)** e escolha uma **Posição**. Arraste uma camada na prévia do nó para movê-la ou puxe a alça do canto dela para redimensioná-la.

### Executar
Clique em **Executar**. O nó renderiza o vídeo com cada camada no seu intervalo. O rótulo da prévia muda de **Prévia** para **Resultado**.

Workflow: Uma captura de tela aparece como cartão e um logo fica no canto; as legendas vão por cima e, depois, o vídeo é publicado.

- Enviar vídeo → Sobreposição em vídeo (vídeo)
- Enviar imagem → Sobreposição em vídeo (camada 1)
- Enviar imagem → Sobreposição em vídeo (camada 2)
- Sobreposição em vídeo → Adicionar legendas (vídeo)
- Adicionar legendas → Publicar no TikTok

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Vídeo** | Nós de vídeo, como **Enviar vídeo** (Upload Video) e **Gerar vídeo** (Generate Video) | O vídeo de base. Obrigatória. |
| **Camada 1** a **Camada 12** | Nós de imagem, como **Enviar imagem** (Upload Image), **Gerar imagem** (Generate Image) e **Sobreposição em imagem** (Image Overlay) | Uma imagem por camada. A Camada 1 é o primeiro conector, a Camada 2 é o segundo, e assim por diante. |

A saída, **Vídeo**, é o vídeo com as camadas desenhadas sobre ele, em MP4.

Use os botões **+ Camada** e **− Camada** no painel de configurações para mostrar entre 1 e 12 conectores de camada. O número também aumenta sozinho quando você conecta um conector mais alto.

## A prévia ao vivo
Depois que um vídeo de base é conectado, o nó mostra um quadro dele com as camadas desenhadas onde a renderização vai colocá-las.

- **Selecione uma camada** clicando na barra dela na **Linha do tempo** do painel de configurações. A prévia salta para o início da camada e mostra só as camadas visíveis naquele momento.
- **Arraste uma camada** para movê-la e puxe a alça do canto dela para redimensioná-la. Cada arrasto grava as novas porcentagens nas configurações da camada, então a prévia e a execução usam os mesmos números.
- **Resultado ou Resultado (antigo).** Depois de uma execução, o nó mostra **Resultado**. Quando você muda as configurações depois disso, por exemplo move uma camada ou conecta outra imagem, o rótulo passa a mostrar **Resultado (antigo)** até você executar de novo.

## Configurações da camada
Cada camada tem o próprio cartão no painel de configurações, com o título **Camada 1**, **Camada 2** e assim por diante.

| Configuração | O que faz |
| --- | --- |
| **Início (s)** | Quando a camada aparece, em segundos desde o início do vídeo. O padrão é `0`. |
| **Fim (s)** | Quando a camada desaparece. Precisa ser depois de **Início (s)**. Deixe vazio para mostrar a camada até o fim do vídeo. |
| **Posição** | **Cartão**, **Selo no canto**, **Quadro inteiro** ou **Personalizado**. Uma camada conectada que você não alterou é um selo no canto inferior direito durante o vídeo inteiro. |
| **Canto** | Para **Selo no canto**: **Superior esquerdo**, **Superior direito**, **Inferior esquerdo** ou **Inferior direito** (o padrão). |
| **Âncora**, **Deslocamento X**, **Deslocamento Y**, **Largura**, **Altura (% do quadro, opcional)**, **Ajuste (quando a altura está definida)** | Para **Personalizado**. Veja [Caixas personalizadas](#custom-boxes). |
| **Ordem das camadas (z)** | De 0 a 100. Uma camada mais alta é desenhada por cima. Vazio significa o número da camada, então a Camada 1 fica embaixo. Os botões para cima e para baixo da prévia também definem essa ordem. |
| **Opacidade** | De 0 a 100%. O padrão é 100%. |
| **Animar entrada e saída** | Ativado por padrão. A camada aparece com um fade enquanto cresce de 96% para 100% do tamanho, em 0,15 segundo, e faz o contrário no fim. |

### Posições
Cada posição e cada tamanho são uma porcentagem do quadro de saída.

| Posição | Onde a camada fica |
| --- | --- |
| **Cartão** | Centralizada, 4% acima do meio, encaixada em 78% × 60% do quadro. A imagem mantém a proporção. |
| **Selo no canto** | Com 18% da largura do quadro, a 4% do canto escolhido. |
| **Quadro inteiro** | Cobre o quadro inteiro. A imagem é recortada para preenchê-lo. |
| **Personalizado** | A sua própria caixa. |

O **Cartão** fica sobre o meio do quadro, que, em um vídeo selfie 9:16, é onde está o rosto de quem fala. Isso é de propósito: os cartões de produto aparecem sobre a pessoa falando. Coloque um logo ou um selo que não pode cobrir o sujeito em um selo no canto ou em uma caixa personalizada.

### Caixas personalizadas
- **Âncora** é uma de nove posições do quadro onde a camada se fixa.
- **Deslocamento X** e **Deslocamento Y** movem a camada a partir da âncora, de −100 a 100% da largura e da altura do quadro. Um deslocamento negativo em uma âncora à direita ou embaixo move a camada para dentro.
- **Largura** vai de 1 a 100% da largura do quadro.
- **Altura (% do quadro, opcional)** vai de 1 a 100% da altura do quadro. Sem ela, a altura segue a proporção da imagem.
- **Ajuste (quando a altura está definida)** decide como a imagem preenche a caixa: **Ajustar** mostra a imagem inteira, centralizada. **Preencher** preenche a caixa e recorta a imagem.

Definir qualquer campo da caixa transforma uma camada com posição predefinida em **Personalizado**. Arrastar ou redimensionar essa camada na prévia faz o mesmo. Uma imagem alta cuja altura segue a proporção é sempre encaixada dentro do quadro: uma imagem 1:10 com 60% de largura em um vídeo 1080×1920 é desenhada em 192×1920. Os tamanhos desenhados são arredondados para baixo até um número par de pixels e têm pelo menos 2×2.

### Regras de tempo
- Os tempos são segundos desde o início do vídeo, de 0 a 3.600. Eles mantêm a precisão que você digita, e a renderização os coloca na grade de quadros do vídeo, então uma camada pode aparecer até um quadro antes ou depois.
- Uma camada cujo **Fim (s)** passa do fim do vídeo é cortada no fim.
- Uma camada que começa no fim do vídeo ou depois dele é ignorada, e a imagem dela não é baixada.
- Uma camada com menos de 0,3 segundo usa metade da duração para cada fade.

O painel avisa sobre camadas cortadas e ignoradas enquanto você digita, usando a duração que o navegador lê. Essa duração pode diferir da duração do próprio vídeo em alguns centésimos de segundo, então os avisos da execução são a palavra final.

## Configurações de saída
| Configuração | O que faz |
| --- | --- |
| **Proporção de saída** | **Igual ao vídeo** (o padrão), `16:9` (1920×1080), `9:16` (1080×1920), `1:1` (1080×1080) ou `4:5` (1080×1350). Com uma proporção de saída, as porcentagens das camadas se referem a esse novo quadro. |
| **Ajuste do vídeo** | Só com uma proporção de saída. **Preencher** (o padrão) preenche o quadro e recorta o vídeo. **Ajustar** mostra o vídeo inteiro e adiciona margens. |
| **Cor de preenchimento** | Só com **Ajustar**. A cor das margens. O padrão é preto. |

Sem uma proporção de saída, o resultado mantém o tamanho de exibição e a taxa de quadros do próprio vídeo. Um clipe de celular armazenado de lado é renderizado na orientação correta, pixels não quadrados são corrigidos, e dimensões ímpares são arredondadas para baixo até números pares, então uma origem de 1079×1919 é renderizada em 1078×1918.

O resultado é um MP4 H.264 que começa a tocar antes de ser baixado por completo. Só a primeira faixa de áudio do vídeo de base é mantida, e um vídeo sem áudio continua sem som.

## Limites
- **Camadas:** de 1 a 20 por execução. Um nó com mais de 20 camadas que têm imagem é recusado antes da execução, e o botão **Executar** informa isso. Remova camadas para voltar a 20; as camadas restantes mantêm os números. Nenhuma camada é descartada sem aviso, e nada é cobrado.
- **Imagens:** PNG, JPEG ou WebP, com até 25 MB cada e 100 MB no total, até 8192 pixels no lado maior e 400 megapixels no total. A orientação da foto registrada pela câmera é aplicada.
- **SVG é recusado.** Converta primeiro um SVG em PNG com o [Sobreposição em imagem](https://nodaro.ai/docs/nodes/image/image-overlay).
- **Imagens animadas**, como WebP animado e APNG, mostram o primeiro quadro.
- **A base precisa ser um vídeo.** Um arquivo de áudio, uma imagem ou uma página da web salva como `.mp4` falha com “The base input is not a video”.
- **Tempo de renderização:** uma renderização para depois de 10 minutos.
- **Taxa da API:** até 30 requisições por minuto por usuário.

## Avisos
Uma execução bem-sucedida pode informar avisos. O painel de configurações os mostra em uma linha de **Última execução**.

| Aviso | Código da API | Significado |
| --- | --- | --- |
| Cortada | `clipped` | O fim da camada passava do fim do vídeo, então ela foi mostrada até o fim. |
| Ignorada | `skipped` | A camada começava no fim do vídeo ou depois dele, então não foi desenhada. |
| Imagem animada | `animated_first_frame` | A imagem era um WebP animado, então foi usado o primeiro quadro dela. |
| Áudio recodificado | `audio_reencoded` | O áudio do vídeo não pôde ser copiado para o MP4 como estava, então foi recodificado para AAC. |

Já quando todas as camadas começam depois do fim do vídeo, a execução falha, com a mensagem “Every layer starts after the video ends”. Uma imagem de camada que não pode ser baixada também faz a execução falhar, por exemplo com “Layer 3: image could not be fetched”.

## Créditos
O Sobreposição em vídeo custa 22 créditos por execução, seja qual for o número de camadas ou a duração do vídeo. Uma execução que falha não é cobrada. Em uma instalação self-hosted da Community Edition não há créditos, e o nó é executado sem nenhuma chave de API.

## Exemplo: cartões de produto sobre uma pessoa falando
Um vídeo selfie 9:16 com três imagens, cada uma mostrada enquanto a pessoa fala dela:

| Camada | Imagem | Início (s) | Fim (s) | Posição |
| --- | --- | --- | --- | --- |
| 1 | pricing-page.png | 1,2 | 2,6 | Cartão |
| 2 | dashboard.png | 3,0 | 4,4 | Cartão |
| 3 | logo.png | 0 | até o fim | Selo no canto, Superior direito |

Em um vídeo 1080×1920, a caixa de cada cartão tem 842×1152 pixels, na posição (119, 307). Uma captura de tela com proporção 1:2 é desenhada dentro dela em 576×1152 pixels, centralizada.

A mesma requisição pela API, `POST /v1/video-overlay`:

```json
{
"videoUrl": "https://example.com/selfie.mp4",
"layers": [
{ "imageUrl": "https://example.com/pricing-page.png", "start": 1.2, "end": 2.6, "preset": "card" },
{ "imageUrl": "https://example.com/dashboard.png", "start": 3.0, "end": 4.4, "preset": "card" },
{ "imageUrl": "https://example.com/logo.png", "start": 0, "preset": "corner-badge", "corner": "top-right" }
]
}
```

Os assistentes de IA usam a ferramenta MCP `overlay_images`, em que cada camada recebe uma `url` ou um `asset_id`. Na linha de comando, use `nodaro media video-overlay`.

## Dicas
- **Mantenha os cartões curtos e separados.** Mostre um cartão por um ou dois segundos e não deixe que os cartões se sobreponham no tempo, para que haja um na tela de cada vez.
- **Use os cantos para camadas de longa duração.** Um logo, um @ ou um preço que fica muito tempo na tela deve ir em um selo no canto ou em uma caixa personalizada, longe de quem fala.
- **Use PNGs transparentes para logos.** Um JPEG opaco é colocado como um retângulo.
- **Mantenha o quadro do próprio vídeo.** Defina **Proporção de saída** só quando precisar de um quadro diferente do da origem.
- **Corte primeiro.** Use o [**Cortar vídeo** (Trim Video)](https://nodaro.ai/docs/nodes/video/trim-video) antes do Sobreposição em vídeo para encurtar o vídeo de base.
- **Legende depois.** Conecte o resultado ao [**Adicionar legendas** (Add Captions)](https://nodaro.ai/docs/nodes/video/add-captions). As camadas ficam embaixo das legendas.
- **Estilize um selo primeiro.** Conecte um resultado do [Sobreposição em imagem](https://nodaro.ai/docs/nodes/image/image-overlay) a um conector de camada para colocar texto, um QR code ou um selo estilizado no vídeo.

## Frequently asked questions

### Quantas imagens o “Sobreposição em vídeo” pode colocar em um vídeo?

Até 20 camadas por execução. O nó no canvas tem até 12 conectores de camada para imagens conectadas. As camadas 13 a 20 vêm de URLs de imagem definidas pela API, pelo MCP ou por um template.

### O “Sobreposição em vídeo” muda o áudio do meu vídeo?

Não. O áudio do vídeo de base é mantido. Ele é copiado como está quando é AAC, MP3, AC-3 ou Opus e, nos outros casos, é recodificado para AAC, o que a execução informa como um aviso.

### Por que o meu cartão cobre o rosto de quem fala?

A posição “Cartão” fica sobre o meio do quadro de propósito, para que os cartões de produto apareçam sobre uma pessoa falando para a câmera. Para um logo ou um selo que não pode cobrir o sujeito, use “Selo no canto” ou uma caixa personalizada.

### Quais formatos de imagem uma camada pode usar?

PNG, JPEG e WebP, com até 25 MB cada e 100 MB no total. SVG é recusado, então converta-o primeiro em PNG com o “Sobreposição em imagem”. Uma imagem animada mostra o primeiro quadro.

### Quantos créditos o “Sobreposição em vídeo” custa?

22 créditos por execução, seja qual for o número de camadas ou a duração do vídeo. Nenhum modelo de IA é executado. Em uma instalação self-hosted da Community Edition, o nó é executado sem créditos nem chaves de API.