# Combinar vídeos

> Junte clipes em um vídeo, na ordem que você definir, com mais de 50 transições, fade cruzado de áudio, cortes nas emendas e tomadas contínuas sem saltos.

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

O nó **Combinar vídeos** (Combine Videos) junta dois ou mais clipes de vídeo em um único vídeo, na ordem que você definir. Entre os clipes, ele pode pôr um corte seco ou uma de mais de 50 transições, misturar o som com um fade cruzado e cortar os quadros duplicados que os clipes de continuação feitos por IA têm nas emendas. Use-o para montar tomadas geradas em uma sequência ou em uma edição final.

- Found in: Video › Cut & Assemble
- Output: video
- API type: `combine-videos`

## Quando usar
- Montar clipes gerados em uma única sequência.
- Juntar vários resultados de imagem para vídeo em um vídeo mais longo.
- Criar uma montagem com clipes de nós de geração diferentes.
- Juntar clipes que continuam um ao outro sem um salto visível, com a predefinição **Junção contínua (tomada única)**.
- Criar um loop perfeito: combine um clipe com ele mesmo e depois adicione uma trilha sonora com o [**Mesclar vídeo e áudio** (Merge Video & Audio)](https://nodaro.ai/docs/nodes/video/merge-video-audio).

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Corte e montagem › Combinar vídeos**.

### Conectar os clipes
Conecte todos os clipes à entrada **Vídeo**. Para enviar todos os resultados de um nó, por exemplo de um nó **Gerar vídeo** (Generate Video) que foi executado uma vez para cada item de uma lista, defina essa conexão como **Conjunto**. Veja [Listas e lotes](https://nodaro.ai/docs/concepts/lists-and-batching).

### Definir a ordem
Abra o painel de configurações. Arraste os clipes na lista **Vídeos conectados** até a ordem em que eles devem tocar.

### Escolher a transição e o som
Escolha uma **Transição**, por exemplo **Fade**, e um modo de **Áudio**. Você também pode começar de uma predefinição da pasta **Junções e transições**.

### Executar
Clique em **Executar** no nó. O vídeo combinado aparece no nó.

Workflow: Três tomadas geradas são unidas com fades, e depois uma faixa de música é adicionada ao vídeo combinado.

- Gerar vídeo → Combinar vídeos (vídeo)
- Gerar vídeo → Combinar vídeos (vídeo)
- Gerar vídeo → Combinar vídeos (vídeo)
- Combinar vídeos → Mesclar vídeo e áudio (mídia)
- Gerar música → Mesclar vídeo e áudio (mídia)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Vídeo** | Nós de vídeo, como Gerar vídeo, **Cortar vídeo** (Trim Video), **Estender vídeo** (Extend Video) e **Enviar vídeo** (Upload Video) | Os clipes a juntar, dois ou mais. Cada conexão adiciona um clipe, e uma conexão **Conjunto** adiciona todos os resultados do nó dela. |

A saída, **Vídeo**, é o vídeo único combinado.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Vídeos conectados** | Os clipes, na ordem de reprodução. Arraste um clipe para movê-lo. |
| **Transição** | A transição entre os clipes. O padrão é **Corte**. Veja [Transições](#transitions). |
| **Duração da transição** | A duração da transição da imagem, de 0,1 a 2 segundos. O padrão é 0,5 segundo. Fica oculta com **Corte**. |
| **Áudio** | **Manter original** mantém o som de cada clipe. **Fade cruzado**, o padrão, mistura o som em cada junção. **Remover áudio** gera um vídeo sem som. |
| **Duração do fade cruzado (só áudio)** | A duração da mistura do áudio, de 0 a 5 segundos. O padrão é 0,5 segundo. Aparece quando **Áudio** está em **Fade cruzado**. Ela nunca muda a imagem. |
| **Curva do fade cruzado** | O formato da mistura do áudio. O padrão é **Linear**. Veja [Curvas do fade cruzado](#crossfade-curves). |
| **Corte nos limites** | Como cada junção é cortada. **Manual**, o padrão, corta um número exato de quadros. Os três métodos **Inteligente** encontram o corte para você. Veja [Cortar as emendas](#trim-the-seams). |
| **Cortar o fim de cada clipe (quadros, exceto o último)** | Só no **Manual**. Quadros removidos do fim de todos os clipes, exceto o último, de 0 a 120. O padrão é 2, que descarta os artefatos de geração na emenda. |
| **Cortar o início de cada clipe (quadros, exceto o primeiro)** | Só no **Manual**. Quadros removidos do início de todos os clipes, exceto o primeiro, de 0 a 120. O padrão é 1, que descarta o quadro duplicado que os clipes de continuação feitos por IA trazem. |
| **Janela de busca: fim do clipe anterior** | Só nos métodos **Inteligente**. Quantos quadros buscar no fim de cada clipe, de 1 a 24. O padrão é 8. |
| **Janela de busca: início do próximo clipe** | Só nos métodos **Inteligente**. Quantos quadros buscar no início do próximo clipe, de 1 a 24. O padrão é 8. |

## Transições
O seletor de transições no painel de configurações tem mais de 50 transições. Cada opção mostra uma prévia em loop, para você compará-las rapidamente. A aba **Mais usadas** reúne as transições mais comuns:

| Transição | Como fica |
| --- | --- |
| **Corte** | Um corte seco: uma troca instantânea, sem mistura. A mais rápida de renderizar. |
| **Fade** | Um fade cruzado suave. Uma mistura clássica e limpa. |
| **Dissolver** | Uma dissolução granulada, com pixels aleatórios. Boa para momentos de lembrança. |
| **Fade para preto** | Um fade que passa pelo preto. Use entre cenas ou para um salto no tempo. |
| **Fade para branco** | Um fade que passa pelo branco. Claro e etéreo, por exemplo para flashbacks. |
| **Cortina à esquerda**, **Cortina à direita** | Uma borda nítida atravessa o quadro. |
| **Deslizar à esquerda**, **Deslizar à direita** | O próximo clipe empurra o atual para fora da tela. |
| **Círculo abrindo** | Uma íris circular se abre a partir do centro e revela o próximo clipe. |

As outras abas agrupam todas as transições por família:

| Aba | Transições |
| --- | --- |
| **Fades** | Corte, Fade, Dissolver, Fade para preto, Fade para branco, Fade por tons de cinza |
| **Cortinas** | Cortina à esquerda, à direita, para cima e para baixo, e Cortina superior esquerda, superior direita, inferior esquerda e inferior direita |
| **Deslizes** | Deslizar à esquerda, à direita, para cima e para baixo |
| **Suaves** | Suave à esquerda, à direita, para cima e para baixo, que são cortinas com a borda suavizada |
| **Formas** | Círculo abrindo, Círculo fechando, Recorte circular, Recorte retangular, Abertura e Fechamento horizontal, Abertura e Fechamento vertical, e quatro diagonais |
| **Fatias** | Fatias horizontais à esquerda, Fatias horizontais à direita, Fatias verticais para cima, Fatias verticais para baixo |
| **Revelações** | Revelar à esquerda, à direita, para cima e para baixo |
| **Coberturas** | Cobrir à esquerda, à direita, para cima e para baixo |
| **Efeitos** | Pixelizar, Cortina radial, Desfoque, Distância, Aproximar, Compressão horizontal, Compressão vertical |

## Som entre os clipes
Com **Áudio** em **Fade cruzado**, o som se mistura em cada junção. O fade cruzado nunca muda a imagem: a duração e a curva dele moldam só o som.

- **Em um corte seco** (**Corte**, ou qualquer transição com duração 0), a imagem troca na hora e o som faz um corte em L. O som do próximo clipe começa exatamente no corte, com um fade in. O som do clipe anterior continua pela duração do fade cruzado depois do corte, com um fade out. Essa cauda prolongada é esticada em alguns por cento, com o tom mantido, e o fade esconde o esticamento.
- **Em uma transição com mistura** (**Fade**, **Dissolver**, as cortinas e as outras), o som de cada clipe fica sincronizado com a imagem dele. O som se mistura durante a transição. Um fade cruzado mais longo que a transição estende a mistura suavemente pelos dois clipes.
- **O último clipe nunca recebe fade out.** O som dele toca até o fim do vídeo.

Todos os clipes são convertidos para um formato comum antes da junção, então clipes de modelos diferentes sempre se encaixam sem problemas. Quando alguns clipes têm som e outros não, os clipes sem som recebem uma faixa silenciosa, para que a trilha sonora combinada nunca seja interrompida.

### Curvas do fade cruzado
| Curva | Quando usar |
| --- | --- |
| **Linear** (o padrão) | Previsível, mas a música pode perder volume no meio da mistura. |
| **Potência igual** | Mantém o volume percebido quase constante. A melhor escolha para música. |
| **Suave (senoide)** | Mais suave que a Potência igual. Boa para diálogo e som ambiente. |
| **Logarítmica** | Segue a forma como o ouvido percebe o volume, com finais longos e lentos. |
| **Exponencial** | Um fade brusco de um lado e um fade lento do outro. Enérgica, boa para momentos de impacto. |

## Cortar as emendas
Os clipes de continuação feitos por IA, em que cada clipe começa do último quadro do clipe anterior, costumam engasgar na emenda. O modelo renderiza um momento quase idêntico dos dois lados da junção. O **Corte nos limites** remove essa duplicação de uma de duas formas.

### Manual
O **Manual** remove um número fixo de quadros de cada lado de todas as junções: **Cortar o fim de cada clipe (quadros, exceto o último)** e **Cortar o início de cada clipe (quadros, exceto o primeiro)**. O início do primeiro clipe e o fim do último nunca são alterados. Os mesmos cortes valem para todas as junções, o que serve para clipes que terminam todos com a mesma dissolução de duração fixa.

### Inteligente
Os métodos Inteligente rodam só no Nodaro Cloud. As edições self-hosted Community e Business oferecem o método Manual, e a API retorna `cloud_only_feature` se o corte inteligente for pedido nelas.

Um método Inteligente compara os últimos quadros de cada clipe com os primeiros quadros do próximo clipe, dentro das duas janelas de busca, e posiciona o corte para você. Cada junção é analisada separadamente, então um vídeo de 3 clipes tem 2 junções independentes.

| Método | Onde fica o corte |
| --- | --- |
| **Inteligente: melhor par** | No par de quadros mais parecidos. O primeiro clipe termina no quadro correspondente, e o próximo começa logo depois do gêmeo desse quadro, então o momento compartilhado toca exatamente uma vez. |
| **Inteligente: pré-roll mantendo o próximo** | Alguns modelos de continuação recomeçam antes da junção e repetem os últimos momentos do clipe anterior. Este método corta no início dessa sobreposição repetida, então a sobreposição toca a partir da cópia do próximo clipe. |
| **Inteligente: pré-roll mantendo o anterior** | Corta no fim da mesma sobreposição. O clipe anterior mantém os quadros originais, que costumam ser mais nítidos, e o próximo clipe descarta a repetição dele. |

- **Só uma correspondência real conta.** Os quadros só contam como correspondência quando são parecidos o bastante para serem o mesmo momento. Os métodos de pré-roll também exigem uma sequência de quadros correspondentes, e não um par isolado.
- **As junções sem correspondência usam os cortes padrão.** Uma junção sem correspondência, por exemplo entre clipes que não continuam um ao outro, volta ao padrão de 1 quadro cortado do início e 2 quadros cortados do fim. Os valores de corte que você definiu no Manual são redefinidos quando você muda para um método Inteligente, então nenhum valor oculto altera esse padrão.
- **A fala não é cortada.** Com **Áudio** em **Fade cruzado** e um corte seco, uma junção com correspondência corta só a imagem do clipe anterior. O som real dele continua tocando sob o início do próximo clipe e termina com um fade out ao longo da duração do fade cruzado. As junções sem correspondência, o método Manual, **Manter original** ou **Remover áudio**, e as transições com mistura cortam imagem e som juntos.
- **As janelas fora do intervalo são corrigidas.** Um valor de janela fora do intervalo de 1 a 24 é levado ao valor permitido mais próximo, por exemplo 48 vira 24 e 0 vira 1. Um valor que não é um número volta para 8. A execução nunca é recusada por isso.

## Predefinições
A pasta **Junções e transições** no menu de predefinições do nó tem cinco predefinições:

| Predefinição | Transição | Som | Cortes de quadros |
| --- | --- | --- | --- |
| **Junção contínua (tomada única)** | Corte | Fade cruzado, **Potência igual** | 4 quadros do fim de cada clipe, 3 do início de cada clipe |
| **Corte seco** | Corte | Manter original | Nenhum |
| **Fade cruzado** | Fade, 0,7 segundo | Fade cruzado, **Potência igual** | Os padrões |
| **Dissolução** | Dissolver, 1 segundo | Fade cruzado, **Potência igual** | Os padrões |
| **Fade pelo preto** | Fade para preto, 1 segundo | Fade cruzado, **Potência igual** | Os padrões |

A **Junção contínua (tomada única)** remove o salto que aparece quando você junta tomadas contínuas, como storyboards de quadro inicial e final ou um clipe estendido com o [Estender vídeo](https://nodaro.ai/docs/nodes/video/extend-video). Esses clipes compartilham um quadro quase idêntico na junção, que parece um tranco. A predefinição mantém um corte seco, então o resultado ainda parece um único take contínuo, e esconde a emenda do som com um fade cruzado de potência igual. Conecte os clipes em ordem e execute.

## Créditos
O Combinar vídeos custa 33 créditos a cada 5 segundos da saída estimada. A estimativa soma as durações dos clipes e depois subtrai as sobreposições das transições e os cortes de quadros. Cada clipe além dos dois primeiros acrescenta mais um bloco, e o mínimo é um bloco.

O botão **Executar** mostra a estimativa atualizada. Um clipe conectado que ainda não foi gerado conta como 8 segundos.

## Dicas
- **Fade na maioria das junções.** Um **Fade** de 0,5 segundo fica limpo entre a maioria dos clipes. Use **Corte** em edições de ritmo rápido ou em clipes que devem parecer uma única tomada contínua.
- **Transições curtas para redes sociais.** De 0,3 a 0,5 segundo mantém o ritmo.
- **Fade para preto entre cenas.** O **Fade para preto** funciona bem entre cenas com lugares ou climas diferentes.
- **Misture o som, não a imagem.** Um fade cruzado de áudio de 0,5 a 1 segundo suaviza uma trilha ambiente em um corte seco, sem mexer na imagem.
- **Remova de uma vez as dissoluções finais do VEO.** Quando todos os clipes terminam com a mesma dissolução, defina **Cortar o fim de cada clipe (quadros, exceto o último)** para removê-la de todos eles.
- **Adicione a música depois.** Conecte o vídeo combinado ao [Mesclar vídeo e áudio](https://nodaro.ai/docs/nodes/video/merge-video-audio) para adicionar uma trilha sonora.

## Pela API
O `POST /v1/combine-videos` e a ferramenta MCP `combine_videos` juntam clipes com as mesmas opções. Quando um método Inteligente é executado, o resultado do job lista cada junção com os cortes aplicados, a pontuação de similaridade e se uma correspondência foi encontrada. Veja [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes) e as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Frequently asked questions

### Como mudo a ordem dos clipes?

Abra o painel de configurações e arraste os clipes na lista “Vídeos conectados”. O primeiro clipe da lista toca primeiro.

### Como junto clipes de continuação sem um salto visível?

Escolha a predefinição “Junção contínua (tomada única)”. Ela mantém um corte seco, corta os quadros duplicados em cada junção e faz um fade cruzado no som. No Nodaro Cloud, os métodos “Inteligente” de corte nos limites também podem encontrar o melhor corte para você.

### O fade cruzado de áudio muda a imagem?

Não. A duração e a curva do fade cruzado moldam só o som. Em um corte seco, a imagem é idêntica com ou sem o fade cruzado.

### Posso usar o corte inteligente em uma instalação self-hosted?

Não. Os métodos “Inteligente” de corte nos limites rodam só no Nodaro Cloud. As edições Community e Business oferecem o método “Manual”, que corta um número exato de quadros em cada junção.

### Como combino todos os resultados de um nó?

Defina a conexão que entra no Combinar vídeos como “Conjunto”. O nó então recebe a lista inteira de clipes em uma única execução e junta todos eles.
