Sobreposição em vídeo
Mostre até 20 camadas de imagem ou vídeo com tempo marcado sobre um vídeo, com layouts empilhados e picture-in-picture, prévia ao vivo e áudio mantido.
O nó Sobreposição em vídeo mostra imagens e vídeos sobre um vídeo, cada um 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, e para dois vídeos juntos: um clipe horizontal na parte de baixo de um quadro vertical, dois clipes empilhados ou um picture-in-picture. O nó desenha os seus arquivos 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 um clipe horizontal na parte de baixo de um quadro vertical, com um cartão de título acima dele.
- Você quer dois clipes empilhados, para uma reação ou um antes e depois.
- Você quer um picture-in-picture fixo, como um convidado, uma gravação de tela ou uma janela de câmera.
- 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 camadas
Conecte o vídeo de base à entrada Vídeo. Conecte cada imagem ou vídeo ao próprio conector de camada: Camada 1, Camada 2 e assim por diante. O nó começa com 4 conectores de camada.
Escolher um layout e definir o tempo e a posição de cada camada
Abra o painel de configurações. Para juntar dois vídeos, escolha primeiro um Layout. 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.
Entradas
| Entrada | Aceita | O que faz |
|---|---|---|
| Vídeo | Nós de vídeo, como Enviar vídeo e Gerar vídeo | O vídeo de base. Obrigatória. |
| Camada 1 a Camada 12 | Nós de imagem, como Enviar imagem, Gerar imagem e Sobreposição em imagem, e nós de vídeo, como Enviar vídeo e Gerar vídeo | Uma imagem ou um vídeo por camada. A Camada 1 é o primeiro conector, a Camada 2 é o segundo, e assim por diante. |
| Plano de camadas | Uma lista de camadas em JSON | Opcional. Mais camadas com tempos, cada uma com a própria URL de imagem ou de vídeo. Veja Entrada Plano de camadas. |
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. Uma camada também pode levar uma URL de imagem ou de vídeo em vez de uma conexão. A API, o MCP e os templates usam isso, e é assim que existem as camadas 13 em diante. Conectar um nó ao conector da camada substitui essa URL.
Entrada Plano de camadas
A entrada Plano de camadas recebe uma lista de camadas em JSON, no formato de camada do próprio nó: imageUrl ou videoUrl, start, end, sound e os campos da caixa anchor, x, y, width, height e fit. Use essa entrada, por exemplo, com um nó que sincroniza cartões de capturas de tela com uma narração, como o Cartões UGC.
- As camadas do plano ficam abaixo das camadas dos conectores, então um selo de logotipo em um conector continua por cima.
- Cada camada do plano precisa da própria
imageUrlouvideoUrl. Uma camada do plano nunca pega o arquivo de um conector. Uma camada do plano sem nenhum dos dois faz a execução falhar. A mensagem começa com “Plan layer 1: no image or video”. - As camadas do plano contam para os limites. As camadas do plano e as camadas dos conectores, juntas, podem ser no máximo 20, e as camadas de vídeo delas, juntas, no máximo 2.
- A prévia mostra as camadas do plano como camadas somente leitura, marcadas como Do plano de camadas.
- Um plano vazio deixa o vídeo passar. Quando um plano de camadas está conectado e não há nenhuma camada para desenhar, o nó entrega o vídeo sem mudanças, sem custo.
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. Uma camada de vídeo mostra o primeiro quadro dela.
- 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.
- Mova o vídeo de base do mesmo jeito, depois de selecioná-lo com Mover na prévia no cartão Vídeo base. Veja O vídeo de base.
- Resultado ou Resultado (antigo). Depois de uma execução, o nó mostra Resultado. Uma execução iniciada de qualquer forma conta: o próprio Executar do nó, uma execução de workflow, um agendamento, um webhook ou uma execução de app. Quando você muda as configurações depois disso, por exemplo move uma camada, conecta outra imagem ou outro vídeo, ou escolhe outro layout, 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. |
| 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 | 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. Ativado por padrão em uma camada de imagem, desativado em uma camada de vídeo. |
| Som › Tocar o som deste vídeo, Volume | Só em uma camada de vídeo. Desativado por padrão. Veja Som. |
Animar entrada e saída vem desativado por padrão em uma camada de vídeo porque um fade apareceria no início e no fim de um vídeo empilhado ou em janela. Em um conector de camada, o padrão segue o que está conectado: conecte um vídeo, e o fade dele fica desativado, a menos que você o ative.
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 ou o vídeo 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 ou o vídeo é recortado 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 ou do vídeo.
- Ajuste (quando a altura está definida) decide como a camada preenche a caixa: Ajustar mostra a imagem ou o vídeo inteiro, centralizado. Preencher preenche a caixa e recorta a camada.
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 o arquivo dela não é baixado.
- 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.
Camadas de vídeo
Uma camada leva uma imagem ou um vídeo, nunca os dois. Na API, uma camada tem um imageUrl ou um videoUrl, e uma camada com os dois é recusada. Uma execução aceita no máximo 2 camadas de vídeo. Todo o resto funciona como em uma camada de imagem: a caixa, Início (s), Fim (s), Opacidade e Ordem das camadas (z). As imagens podem ficar acima dos vídeos, e o vídeo de base fica sempre embaixo.
- Uma camada de vídeo toca a partir do próprio primeiro quadro, começando no Início (s) da camada.
- Ela para no Fim (s) da camada, ou no fim do vídeo de base quando a camada não tem fim.
- Se o vídeo da camada for mais curto, ele mantém o último quadro até o fim da janela dele.
- Ajuste funciona como em uma imagem. Ajustar mostra o vídeo inteiro na caixa, e Preencher preenche a caixa e recorta o vídeo. Sem uma altura, a caixa segue o formato do próprio vídeo.
- A saída mantém a taxa de quadros do vídeo de base. Um vídeo de camada com outra taxa de quadros é desenhado na taxa da base.
- Em um conector de camada, a conexão decide se a camada é uma imagem ou um vídeo.
Som
- Por padrão, só o som do vídeo de base toca, exatamente como sem camadas de vídeo.
- Uma camada de vídeo fica sem som, a menos que o som dela esteja ativado. No canvas, abra a seção Som da camada, ative Tocar o som deste vídeo e defina o Volume de 0 a 100%. Na API, defina
sound: { volume }, de 0 a 1, em que 1 é o som como foi gravado. - O som de uma camada é mixado com o som da base durante a janela da camada, no volume dela. A mixagem passa por um limitador, então duas fontes altas em volume máximo não distorcem. Níveis normais não são aumentados nem diminuídos.
- Uma trilha mixada é AAC, com a duração do vídeo. Com um vídeo de base sem som, a trilha é só o som da camada, completado com silêncio.
- Um vídeo de camada sem faixa de áudio é desenhado sem som, e a execução informa o aviso
layer_no_audio. - O som é só para uma camada de vídeo. Na API, uma camada que leva uma imagem e um
soundé recusada. Em um conector de camada que recebe uma imagem na execução, um som salvo é ignorado e a execução continua.
Layouts
Um layout posiciona o vídeo de base, a primeira camada de vídeo ou os dois, com uma só escolha. A primeira camada de vídeo é a camada de vídeo mais baixa na ordem das camadas. As camadas de imagem ficam onde você as colocou. No canvas, escolha-o no seletor Layout, no topo do painel de configurações. Personalizado significa nenhum layout. Na API, no MCP, no SDK e na CLI, é o campo layout da requisição.
| Layout | layout | Vídeo de base | Primeira camada de vídeo | Exige |
|---|---|---|---|---|
| Vídeo embaixo | video-bottom | Inteiro, na largura total, junto à borda inferior | Não posicionada | Uma proporção de saída |
| Vídeo em cima | video-top | Inteiro, na largura total, junto à borda superior | Não posicionada | Uma proporção de saída |
| Empilhado inteiro | stack-whole | Inteiro, logo acima da primeira camada de vídeo | Inteira, logo abaixo da base | Uma proporção de saída e uma camada de vídeo |
| Empilhado preenchido | stack-filled | A metade de cima, recortada para preencher | A metade de baixo, recortada para preencher | Uma proporção de saída e uma camada de vídeo |
| Picture-in-picture | pip | Como sem layout | Com 30% da largura do quadro, a 4% do canto dela (inferior direito por padrão) | Uma camada de vídeo |
| Personalizado | nenhum | Como você posicionar | Como você posicionar | Nada |
- Empilhado inteiro mostra os dois vídeos inteiros, com a mesma largura, encostados. O par fica centralizado, com o mesmo espaço acima e abaixo. Os vídeos só diminuem juntos quando os dois são mais altos que o quadro. Dois vídeos 16:9 em um quadro 1080×1920 são desenhados em 1080×606 cada, com 354 pixels acima e abaixo.
- Empilhado preenchido em um quadro 1080×1920 preenche a metade de cima (y de 0 a 960) com a base e a metade de baixo (y de 960 a 1920) com a camada de vídeo. Os dois são recortados.
- Vídeo embaixo com uma base 16:9 em um quadro 1080×1920 desenha a base em y de 1314 a 1920, junto à borda inferior. As camadas de imagem acima dela ficam onde você as colocar.
- Vídeo embaixo e Vídeo em cima não exigem camada de vídeo. Só com camadas de imagem, a execução mantém o preço só com imagens.
- Picture-in-picture pega o canto do Canto da primeira camada de vídeo e substitui qualquer caixa que essa camada tinha.
- Picture-in-picture e os dois empilhados desativam o fade da primeira camada de vídeo. Vídeo embaixo e Vídeo em cima deixam todas as camadas como estão.
Estas requisições são recusadas:
- Um layout que exige uma proporção de saída, sem ela: “layout video-bottom needs an outputAspect”.
- Um layout que exige uma camada de vídeo, sem ela: “layout pip needs a video layer — set videoUrl on a layer or connect a video to a layer's handle”.
- Um layout empilhado com uma caixa de base, porque um empilhado posiciona a base sozinho: “A stack layout places the base itself — remove baseBox or choose Custom”.
Uma caixa de base que você define tem prioridade sobre Vídeo embaixo e Vídeo em cima.
No canvas:
- Escolher um layout que exige uma proporção de saída, quando nenhuma está definida, define Proporção de saída como 9:16.
- Escolher qualquer layout remove uma caixa de base que você posicionou.
- Mover ou redimensionar uma camada, mudar a posição dela ou mover o vídeo de base transforma o layout em Personalizado. Tudo fica onde está.
- Com Picture-in-picture ou um empilhado, mudar o fade da primeira camada de vídeo também transforma o layout em Personalizado.
O vídeo de base
Por padrão, o vídeo de base preenche a saída como descrito em Configurações de saída. Com uma proporção de saída, você também pode posicionar o vídeo de base, com uma caixa de base. Uma caixa de base usa os mesmos campos da caixa personalizada de uma camada: Âncora, Deslocamento X, Deslocamento Y, Largura, uma Altura opcional e Ajuste. Na API, ela é baseBox: anchor e width são obrigatórios, x e y têm padrão 0, e fit tem padrão contain. Uma caixa de base substitui o Ajuste do vídeo. Qualquer parte do quadro que a base não cobre mostra a Cor de preenchimento. Uma caixa de base sem proporção de saída é recusada: “baseBox needs an outputAspect”.
O cartão Vídeo base no painel de configurações mostra onde a base está:
- Sem uma proporção de saída, o cartão diz que é preciso uma para mover a base.
- Com um layout empilhado, o cartão diz que o layout posiciona a base. Ele oferece Mover na prévia depois que os formatos dos dois vídeos são lidos.
- Posicionada pelo Ajuste do vídeo, o cartão oferece Mover na prévia.
- Com Vídeo embaixo ou Vídeo em cima, sem uma caixa própria, o cartão mostra a caixa do layout como campos, com Mover na prévia. Editar um campo transforma o layout em Personalizado.
- Com uma caixa própria, o cartão mostra os campos da caixa e Redefinir. Redefinir remove a caixa, e o Ajuste do vídeo volta a posicionar a base.
Pressione Mover na prévia para selecionar o vídeo de base. Você pode então arrastá-lo e redimensioná-lo na prévia, como uma camada, e o primeiro movimento dá a ele uma caixa própria. Com qualquer layout, o primeiro movimento transforma o layout em Personalizado e mantém tudo onde está. Quando a base não está selecionada, ela não recebe cliques na prévia, então arrastar o corpo do nó move o nó como antes.
Configurações de saída
| Configuração | O que faz |
|---|---|
| Layout | Vídeo embaixo, Vídeo em cima, Empilhado inteiro, Empilhado preenchido, Picture-in-picture ou Personalizado (o padrão). Veja Layouts. |
| 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. Igual ao vídeo também remove uma caixa de base e um layout que exige uma proporção. |
| 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. Uma caixa de base ou um layout posiciona a base no lugar dele. |
| Cor de preenchimento | Com Ajustar, ou em volta de uma caixa de base. 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, a menos que uma camada de vídeo tenha o som ativado. Veja Som.
Limites
- Camadas: de 1 a 20 por execução. Um nó com mais de 20 camadas que têm uma imagem ou um vídeo é 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.
- Camadas de vídeo: no máximo 2 por execução. Uma requisição com mais é recusada, por exemplo com “At most 2 video layers (got 3)”.
- Duração do vídeo de base com uma camada de vídeo: até 60 segundos. O vídeo de base é medido antes de qualquer cobrança, na API e em uma execução de workflow. Uma base mais longa é recusada com “The base video is 61 seconds. A Video Overlay with a video layer takes a base of up to 60 seconds — trim it first.” Uma base que não pode ser lida é recusada com “Could not read the base video. The file may be corrupted or an unsupported format.” No canvas, o painel de configurações avisa sobre uma base com mais de 60 segundos, e a medição do servidor decide. Uma execução só com camadas de imagem não tem limite de duração.
- Links de vídeo: um link precisa apontar para um arquivo de vídeo comum, não para uma playlist de transmissão contínua (HLS ou DASH). Um link assim é recusado antes de qualquer cobrança. Veja Links de mídia.
- Vídeos de camada: até 200 MB cada. Um maior faz a execução falhar, por exemplo com “Layer 2: video is too large (over 200 MB)”. Um vídeo que não pode ser baixado falha com “Layer 2: video could not be fetched”. Um arquivo que não é vídeo, como uma imagem, um arquivo de áudio ou uma página da web, falha com “Layer 2: not a video”.
- 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
.mp4falha com “The base input is not a video”. - Um vídeo empilhado que começa tarde demais: com um layout empilhado, uma primeira camada de vídeo que começa no fim do vídeo de base ou depois dele é recusada antes de qualquer cobrança.
- 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. |
| Camada sem som | layer_no_audio | Uma camada de vídeo tinha o som ativado, mas o vídeo dela não tem som, então nada foi mixado. |
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”. Com uma camada de vídeo, isso é verificado antes de qualquer cobrança. 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”. Uma execução que falha não é cobrada.
Créditos
- Só camadas de imagem: 22 créditos por execução, seja qual for o número de camadas ou a duração do vídeo.
- Qualquer camada de vídeo: a execução é cobrada a cada 5 segundos iniciados do vídeo de base, que é também a duração da saída. Uma fração de até 0,05 segundo além de um segundo inteiro é ignorada, então uma base de 10,01 segundos conta como 2 unidades, não 3. A duração é a da imagem da base: a duração da própria faixa de vídeo, ou então a tag
DURATIONdela (um WebM ou MKV informa a duração da imagem só ali), ou então o fim do último quadro. Só quando nada disso pode ser lido é usada a duração do arquivo inteiro, menos 0,15 segundo, porque o som de um clipe gerado pode levar o arquivo até esse ponto além da imagem.
O que decide o preço é se alguma camada é um vídeo, não o layout. Vídeo embaixo só com camadas de imagem mantém o preço só com imagens.
O botão Executar mostra o preço antes de uma execução. Para uma execução com uma camada de vídeo, o botão Executar, o preço do nó e a estimativa de um workflow (no editor, por POST /v1/credits/estimate-workflow e pelo MCP) leem a mesma duração de base. Uma base que você envia ou adiciona da Biblioteca é cotada pela duração registrada para ela. Uma base que outro nó faz nesta execução é cotada pela duração que esse nó vai produzir. Uma geração é cotada pela duração definida, ou pelo clipe mais longo do modelo dela em Automático. Um Estender vídeo é cotado pela origem mais os segundos que ele acrescenta. Cada clipe feito no caminho acrescenta cerca de um quadro. Uma extensão do PixVerse V6 acrescenta um quarto de segundo no lugar disso, porque a imagem dela passa mais da duração planejada. Uma Dublagem acrescenta só o quadro, porque a duração extra dela é som, que este nó não cobra. Quando a duração não é conhecida, a estimativa usa o limite de 60 segundos, então a cotação nunca fica abaixo da cobrança. Um conector de camada ligado a um nó que pode entregar um vídeo, e um plano de camadas cujas camadas só são conhecidas na execução, são cotados como uma execução com uma camada de vídeo. O plano de camadas do Cartões UGC só tem imagens de cartões, então mantém o preço só com imagens.
A renderização mede o vídeo de base de novo. Se um link agora entrega um vídeo mais longo do que aquele pelo qual a execução foi cotada, a execução é recusada antes de qualquer desenho, e a cobrança é reembolsada.
Na API, GET /v1/credits/model-cost?model=video-overlay retorna o preço só com imagens, e GET /v1/credits/model-cost?model=video-overlay:video retorna o preço de uma unidade de 5 segundos.
Uma execução que falha não é cobrada. Em uma instalação auto-hospedada 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:
{
"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" }
]
}Exemplos: vídeos juntos
Um vídeo 16:9 na parte de baixo de um quadro 9:16, com um cartão acima dele. O vídeo de base é desenhado em 1080×606, em y de 1314 a 1920. O cartão fica no espaço preto acima dele. Esta execução só tem camadas de imagem, então mantém o preço só com imagens.
{
"videoUrl": "https://example.com/talk-16x9.mp4",
"outputAspect": "9:16",
"layout": "video-bottom",
"layers": [
{ "imageUrl": "https://example.com/card.png", "start": 0, "anchor": "top", "x": 0, "y": 8, "width": 80 }
]
}Dois vídeos 16:9 empilhados, inteiros. Cada vídeo é desenhado em 1080×606, com 354 pixels acima e abaixo. Se o segundo vídeo for mais curto que a base, ele mantém o último quadro.
{
"videoUrl": "https://example.com/a.mp4",
"outputAspect": "9:16",
"layout": "stack-whole",
"layers": [ { "videoUrl": "https://example.com/b.mp4", "start": 0 } ]
}Um picture-in-picture fixo com o som da janela ativado. A janela tem 30% da largura do quadro, a 4% do canto superior direito. O som dela é mixado com o som da base em 80%.
{
"videoUrl": "https://example.com/main.mp4",
"layout": "pip",
"layers": [ { "videoUrl": "https://example.com/guest.mp4", "start": 0, "corner": "top-right", "sound": { "volume": 0.8 } } ]
}Os assistentes de IA usam a ferramenta MCP overlay_images. Cada camada recebe uma url ou um asset_id para uma imagem, e um video_url ou um video_asset_id para um vídeo. A ferramenta também aceita layout e base_box. Na linha de comando, use nodaro media video-overlay, com as camadas de vídeo em --layers-file e as opções --layout e --base-box.
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.
- Para dois vídeos, escolha primeiro um layout. Depois, ajuste a partir dele.
- Corte primeiro. Use o Cortar vídeo antes do Sobreposição em vídeo para encurtar o vídeo de base. Uma execução com uma camada de vídeo aceita uma base de até 60 segundos.
- Ative o som de uma camada só quando ele precisar ser ouvido. Em volume máximo sobre um vídeo de base alto, abaixe um dos dois.
- Legende depois. Conecte o resultado ao Adicionar legendas. 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.
Perguntas frequentes
Quantas camadas o “Sobreposição em vídeo” pode colocar em um vídeo?
Até 20 camadas por execução, e no máximo 2 delas podem ser vídeos. O nó no canvas tem até 12 conectores de camada. As camadas 13 a 20 vêm de URLs de imagem ou de vídeo definidas pela API, pelo MCP ou por um template.
Posso colocar um vídeo sobre outro vídeo?
Sim. Uma camada pode ser uma imagem ou um vídeo. Escolha um layout como “Vídeo embaixo”, “Empilhado inteiro”, “Empilhado preenchido” ou “Picture-in-picture”, ou posicione a camada de vídeo na sua própria caixa. Uma execução com uma camada de vídeo aceita um vídeo de base de até 60 segundos.
O “Sobreposição em vídeo” muda o áudio do meu vídeo?
Não por padrão. Só o som do vídeo de base toca, copiado como está quando é AAC, MP3, AC-3 ou Opus e, nos outros casos, recodificado para AAC. Uma camada de vídeo fica sem som, a menos que você ative o som dela, que então é mixado com o som da base.
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. Um vídeo de camada pode ter até 200 MB.
Quantos créditos o “Sobreposição em vídeo” custa?
Uma execução só com camadas de imagem custa 22 créditos, seja qual for o número de camadas ou a duração do vídeo. Uma execução com qualquer camada de vídeo é cobrada a cada 5 segundos iniciados do vídeo de base. Em uma instalação auto-hospedada da Community Edition, o nó é executado sem créditos nem chaves de API.
Páginas relacionadas
Sobreposição em imagem
Adicionar legendas
Sobreposição Lottie
Cortar vídeo
Enviar imagem
Última atualização
Renderizar vídeo
Renderize em MP4 planos de Gráficos animados, Título 3D, Efeitos de vídeo, Sobreposição Lottie, Compor vídeo ou cenas 3D, ou organize mídias sem plano.
Gerar cena 3D
Descreva uma tomada e receba uma cena 3D de massinha animada e editável para previz, com objetos, câmera e timing, e renderize como referência de layout.