# Plano de edição

> Planeje uma edição a partir da transcrição de uma gravação. Enxugue, encontre clipes curtos ou marque capítulos, em uma EDL que o Aplicar EDL renderiza.

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

O nó **Plano de edição** (Edit Plan) lê a transcrição com tempos de uma gravação e escreve uma lista de decisões de edição (EDL): um plano em JSON que o nó [**Aplicar EDL** (Apply EDL)](https://nodaro.ai/docs/nodes/video/apply-edl) renderiza em um corte final. O Plano de edição lê a transcrição, nunca os pixels, então planeja de forma rápida e barata. Ele tem três modos: **Enxugar** limpa a gravação inteira, **Clipes** encontra momentos curtos para compartilhar, e **Capítulos** marca capítulos com títulos.

- Found in: Video › Cut & Assemble
- Output: data
- API type: `edit-plan`

O Plano de edição roda no Nodaro Cloud. Em uma instalação self-hosted, [conecte a instalação ao Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect), em **Integrações › nodaro.ai** ou com uma chave de API, e o nó repassa cada execução para a nuvem. Sem conexão, o nó fica salvo no canvas, mas não pode ser executado.

## Quando usar
- Enxugar a gravação longa de um podcast ou de uma entrevista antes de renderizá-la.
- Encontrar os melhores momentos curtos de um episódio e renderizar cada um como um clipe separado.
- Gerar marcadores de capítulo com títulos para um vídeo longo.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Corte e montagem › Plano de edição**.

### Conectar a transcrição
Conecte a saída JSON de um nó [**Transcrever** (Transcribe)](https://nodaro.ai/docs/nodes/audio/transcribe) à entrada **Transcrição**. A transcrição precisa ter os tempos de cada palavra.

### Conectar as mídias
Conecte a gravação à entrada **Origens**. Você pode conectar de 1 a 6 origens, por exemplo várias câmeras e um microfone separado. No painel de configurações, dê a cada origem a função dela.

### Escolher o modo
Escolha um **Modo** e um **Nível**. Para **Enxugar**, conecte também um nó [**Detectar silêncio** (Silence Detect)](https://nodaro.ai/docs/nodes/audio/silence-detect) à entrada **Silêncio**, para que o plano corte os silêncios com precisão.

### Executar e renderizar o plano
Clique em **Executar** no nó e depois conecte a saída **Plano de edição (EDL)** dele a um nó [Aplicar EDL](https://nodaro.ai/docs/nodes/video/apply-edl) para renderizar o corte.

Workflow: O Plano de edição encontra cinco clipes curtos em um episódio transcrito, e o Aplicar EDL renderiza cada clipe como um vídeo separado.

- Enviar vídeo → Transcrever (áudio)
- Enviar vídeo → Detectar silêncio (áudio)
- Transcrever → Plano de edição (transcrição)
- Detectar silêncio → Plano de edição (silêncio)
- Enviar vídeo → Plano de edição (origens)
- Plano de edição → Aplicar EDL (EDL)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Transcrição** | Transcrições em JSON, como a saída do Transcrever | A transcrição da gravação, com os tempos de cada palavra. Obrigatória. |
| **Silêncio** | A saída JSON do Detectar silêncio | Os trechos silenciosos da gravação. Opcional. Eles ajudam o **Enxugar** a cortar os silêncios com precisão. |
| **Deslocamentos (Sincronizar áudio)** | A saída **Deslocamentos** do [**Sincronizar áudio** (Audio Sync)](https://nodaro.ai/docs/nodes/audio/audio-sync) | O deslocamento medido de cada gravação, para uma edição com várias câmeras. Opcional. Veja [Gravações com várias câmeras](#multicam-recordings). |
| **Origens** | Nós de vídeo e de áudio | As mídias de onde a edição tira o material, de 1 a 6 origens. Obrigatória. Cada origem vira uma origem da EDL. |

A saída, **Plano de edição (EDL)**, depende do modo:

| Modo | Saída |
| --- | --- |
| **Enxugar** | Uma EDL: uma versão limpa da gravação inteira. |
| **Clipes** | Uma lista de EDLs, uma por clipe. A saída se desdobra, então um nó Aplicar EDL conectado a ela renderiza todos os clipes, em paralelo. |
| **Capítulos** | Uma lista de capítulos, cada um com um tempo de início em milissegundos e um título. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Modo** | **Enxugar (limpar a gravação)**, o padrão, remove silêncios, vícios de linguagem e falsos começos. **Clipes (encontrar clipes curtos)** encontra os melhores momentos curtos para compartilhar. **Capítulos (marcar capítulos)** marca o início dos capítulos com títulos. |
| **Nível** | **Econômico (mais rápido)**, **Padrão** (a opção padrão) ou **Premium (maior fidelidade)**. O nível define a qualidade do plano e o preço dele. |
| **Instruções** | Uma orientação curta para o plano, por exemplo `keep the intro tight, drop the sponsor read`. |
| **Guia de estilo** | Orientações editoriais mais longas que o plano deve seguir. |
| **Número de clipes** | Só no modo **Clipes**. Quantos clipes encontrar, de 1 a 50. Deixe vazio para o planejador decidir. |
| **Duração desejada do clipe (segundos)** | Só no modo **Clipes**. A duração de clipe a buscar, de 5 a 180 segundos. O planejador mira perto dela, mas ela não é um limite rígido. Deixe vazio para o planejador decidir. |
| **Proporção desejada** | **Qualquer** (o padrão), `16:9`, `9:16`, `1:1` ou `4:5`. O formato de entrega, que orienta o enquadramento dos clipes. |
| **Origens** | As mídias conectadas, em ordem. Arraste para reordená-las e dê a cada origem uma função: **Automático** (o padrão), **Áudio principal**, **Câmera**, **Plano geral** ou **Tela**. Cada origem também tem uma caixa de deslocamento, em segundos. Veja [Gravações com várias câmeras](#multicam-recordings). |
| **Texto antes e depois** | Texto que é sempre adicionado antes e depois das instruções. Ele fica oculto para quem usa o seu workflow como app. Veja [Texto antes e depois do prompt](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

Uma origem com a função **Áudio principal** dá o som dela a todos os segmentos da edição, então trocar de câmera nunca muda o som. Veja no [Aplicar EDL](https://nodaro.ai/docs/nodes/video/apply-edl) como as funções são renderizadas.

## Gravações com várias câmeras
Quando uma conversa é gravada em vários aparelhos, como um microfone e duas câmeras, cada arquivo começa em um momento diferente. O Plano de edição coloca todas as origens em um único relógio, o relógio da origem mestre. A origem mestre é a que tem a função **Áudio principal** ou, se nenhuma tiver, a primeira origem da lista.

**Defina os deslocamentos à mão.** Cada origem da lista **Origens** tem uma caixa de deslocamento, em segundos: quanto tempo depois da origem mestre a gravação começou. Um valor negativo indica que a gravação começou antes da origem mestre. O deslocamento da própria origem mestre precisa ser 0.

**Ou meça-os com o Sincronizar áudio.** Conecte cada gravação a um nó [Sincronizar áudio](https://nodaro.ai/docs/nodes/audio/audio-sync) e às **Origens** do Plano de edição. Depois, conecte a saída **Deslocamentos** do Sincronizar áudio à entrada **Deslocamentos (Sincronizar áudio)**. Use os mesmos nós de origem nos dois lugares, porque cada deslocamento é associado à sua origem pelo nó. A referência do Sincronizar áudio não precisa ser a origem mestre: o Plano de edição converte os deslocamentos para o relógio da origem mestre.

Uma caixa de deslocamento vazia mostra **auto**. Ela usa a medição do Sincronizar áudio quando os **Deslocamentos** dele estão conectados, e 0 nos outros casos. Um valor digitado sempre prevalece sobre um valor medido.

Workflow: O Sincronizar áudio mede a distância de cada câmera em relação ao microfone, e o Plano de edição corta as três gravações no relógio do microfone.

- Enviar áudio → Sincronizar áudio (origens)
- Enviar vídeo → Sincronizar áudio (origens)
- Enviar vídeo → Sincronizar áudio (origens)
- Enviar áudio → Transcrever (áudio)
- Enviar áudio → Plano de edição (origens)
- Enviar vídeo → Plano de edição (origens)
- Enviar vídeo → Plano de edição (origens)
- Sincronizar áudio → Plano de edição (deslocamentos)
- Transcrever → Plano de edição (transcrição)
- Plano de edição → Aplicar EDL (EDL)

**Qual câmera cada corte mostra.** Cada corte vai para a primeira câmera, na ordem das origens, que tem imagem do corte inteiro. Um corte que nenhuma câmera cobre sozinha é dividido onde as câmeras começam e param. Quando uma câmera para e nenhuma outra filmou o momento seguinte, até meio segundo fica no último quadro dela. Um trecho mais longo que nenhuma câmera filmou fica fora do plano, e o plano o lista entre os cortes descartados, com o motivo `no-picture`. No modo **Clipes**, um clipe com pelo menos metade filmada mantém a parte filmada. Um clipe com menos da metade filmada fica de fora, e o próximo melhor clipe toma o lugar dele.

**Som.** Todo corte mantém o som da origem mestre, seja qual for a câmera que ele mostra. A trilha sonora nunca troca de microfone em uma troca de câmera.

**O Plano de edição para antes de cobrar** quando os deslocamentos deixariam o corte fora de sincronia:

- O Sincronizar áudio não mediu uma origem, e a origem não tem um deslocamento digitado. Conecte-a ao Sincronizar áudio ou digite o deslocamento dela: 0 se ela começou junto com a origem mestre.
- A correspondência de uma origem é fraca: a confiança é menor que 0,5. Uma câmera sem som utilizável fica com 0. Digite o deslocamento dela.
- Outra origem usa um deslocamento medido, mas o Sincronizar áudio não mediu a origem mestre, ou a correspondência dela é fraca.
- A origem mestre tem um deslocamento diferente de 0.
- A transcrição foi feita a partir de uma gravação fora do relógio da origem mestre. Transcreva a origem mestre ou dê a essa gravação a função **Áudio principal**. No canvas, o Plano de edição segue um nó Transcrever até a gravação que ele transcreveu, também através do **Extrair áudio** (Extract Audio).
- A entrada **Deslocamentos (Sincronizar áudio)** está conectada, mas não traz um resultado do Sincronizar áudio. Execute o Sincronizar áudio antes ou desconecte a entrada.

Um deslocamento digitado sempre prevalece, então ele corrige qualquer origem isolada que o som não conseguiu alinhar. O Plano de edição também recusa um plano em que nenhuma câmera tem imagem. Isso costuma indicar um deslocamento na unidade errada ou com o sinal errado.

## Créditos
O preço do Plano de edição depende da duração da gravação e do nível. A duração é arredondada para cima até uma faixa de 15, 30, 60, 90, 120 ou 180 minutos.

O preço cresce com a faixa e o nível, e o modo **Clipes** acrescenta um valor fixo.

| Exemplo | Faixa | Créditos |
| --- | --- | --- |
| Enxugar, Padrão, episódio de 45 minutos | 60 minutos | 264 |
| Capítulos, Econômico, episódio de 20 minutos | 30 minutos | 66 |
| Clipes, Premium, episódio de 90 minutos | 90 minutos | 836 |

A renderização do plano com o Aplicar EDL é cobrada à parte, por minuto de saída.

### A estimativa antes da execução
O custo mostrado no nó, no botão **Executar** e na confirmação da execução é uma estimativa. Ela usa a duração registrada da origem mestre: a origem com a função **Áudio principal** ou, se não houver uma, a primeira origem na ordem do nó.

- **Áudio e vídeo enviados, e vídeo gerado,** trazem a própria duração, então a estimativa cai na faixa certa.
- **Um link do YouTube extraído com o [Áudio de referência](https://nodaro.ai/docs/nodes/audio/reference-audio) (Reference Audio)** registra a duração do arquivo extraído, então a estimativa também fica certa.
- **Uma origem sem duração registrada,** como um link direto de áudio, é estimada pela maior faixa, de 180 minutos. Extrair de novo uma origem do YouTube registra a duração dela.

A estimativa nunca usa a duração da transcrição conectada. Essa transcrição vem da execução anterior e, depois que você troca o episódio por um mais longo, ela subestimaria o novo episódio. Quando a duração é desconhecida, a estimativa é alta de propósito, para que uma execução seja recusada logo no início, em vez de falhar no meio depois que os nós anteriores já foram cobrados. Seja qual for a estimativa, a cobrança é conferida com a duração real da gravação. O servidor mede a origem mestre antes de reservar os créditos, e uma execução cuja origem mestre não pode ser medida é recusada e reembolsada.

## Dicas
- **Conecte a cadeia completa.** Conecte o Transcrever à **Transcrição**, adicione o Detectar silêncio à entrada **Silêncio** para o **Enxugar** e conecte o **Plano de edição (EDL)** ao Aplicar EDL.
- **Renderize vários clipes a partir de um plano.** No modo **Clipes**, um nó Plano de edição alimenta várias renderizações por meio de um único nó Aplicar EDL.
- **Faça o rascunho no Econômico.** Use o **Econômico** para uma primeira passada rápida, e o **Premium** para o plano final.
- **Defina o áudio principal.** Quando você grava com várias câmeras e um bom microfone, dê à origem do microfone a função **Áudio principal**.

## Pela API
A ferramenta MCP `plan_edit` e o `POST /v1/edit-plan` executam o mesmo planejador com 1 a 6 origens de mídia. A API também aceita uma indicação de `platform`, que orienta o ritmo e a duração do plano. O plano pronto fica no resultado do job, pronto para ser passado ao `apply_edl`. Veja as [ferramentas MCP](https://nodaro.ai/docs/mcp/tools) e [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes).

Pela REST, cada origem traz o próprio deslocamento em milissegundos, em `sources[].offsetMs`. Aplique o resultado do Sincronizar áudio às origens antes de chamar a rota. Um campo `offsets` bruto responde `422 offsets_not_applied`. Um deslocamento na origem mestre, ou na origem indicada por `transcript.sourceId`, responde `422 master_offset`. As duas recusas acontecem antes de qualquer medição ou cobrança. A ferramenta MCP `plan_edit` recebe o resultado do Sincronizar áudio como `offsets`, aplica-o às origens para você e faz as verificações de [Gravações com várias câmeras](#multicam-recordings).

## Frequently asked questions

### O Plano de edição renderiza um vídeo?

Não. O Plano de edição escreve um plano, uma lista de decisões de edição. Conecte a saída dele a um nó “Aplicar EDL”, que renderiza o corte final.

### Quanto custa o Plano de edição?

O preço depende do modo, do nível e da duração da gravação, arredondada para cima para 15, 30, 60, 90, 120 ou 180 minutos. Ele vai de 33 créditos, para até 15 minutos em “Enxugar” ou “Capítulos” no nível Econômico, a 1.628 créditos, para 180 minutos em “Clipes” no nível Premium. O modo “Clipes” custa mais que “Enxugar” e “Capítulos”.

### O Plano de edição pode encontrar vários clipes curtos em uma execução?

Sim. No modo “Clipes”, ele retorna um plano por clipe, e a saída se desdobra, então um único nó “Aplicar EDL” conectado a ela renderiza todos os clipes em paralelo.

### O Plano de edição funciona em uma instalação self-hosted?

Sim, quando a instalação está conectada ao Nodaro Cloud. O nó repassa cada execução para a nuvem. Sem conexão, você pode adicionar e salvar o nó, mas ele não pode ser executado.

### O Plano de edição consegue alinhar gravações de várias câmeras?

Sim. Dê a cada origem um deslocamento em segundos, ou conecte a saída Deslocamentos do Sincronizar áudio à entrada Deslocamentos (Sincronizar áudio) para medi-los. O plano segue o relógio da origem mestre, e cada corte mostra a primeira câmera que filmou aquele trecho.

### Por que a estimativa mostra um preço de 180 minutos?

A estimativa usa a duração registrada da origem principal. Quando uma origem não tem duração registrada, como um link direto de áudio, a estimativa considera a maior faixa. Você paga pela duração real, que o servidor mede antes de reservar os créditos.