Sobreposição em vídeo

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.

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

Entradas

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.

Posições

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

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

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

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:

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:

{
  "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) antes do Sobreposição em vídeo para encurtar o vídeo de base.
• Legende depois. Conecte o resultado ao Adicionar legendas (Add Captions). As camadas ficam embaixo das legendas.
• Estilize um selo primeiro. Conecte um resultado do Sobreposição em imagem a um conector de camada para colocar texto, um QR code ou um selo estilizado no vídeo.