# Cortes de plano

> Encontre onde cada plano de um vídeo começa e termina, medido no próprio arquivo, e, se quiser, salve o primeiro e o último quadro de cada plano como imagens.

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

O nó **Cortes de plano** encontra onde cada plano de um vídeo começa e termina. Ele lista cada plano com o início, o fim e a duração. Ative **Salvar primeiro e último quadro** para também receber o primeiro e o último quadro de cada plano como imagens.

O nó mede o próprio arquivo. Cada quadro decodificado é comparado com o anterior, e um quadro que muda bruscamente a partir de um fundo estável começa um novo plano. É a mesma regra que a [**Máscara de vídeo**](https://nodaro.ai/docs/nodes/video/video-mask) usa para mascarar um vídeo plano a plano.

O nó é executado localmente, sem modelo de IA e sem chave de provedor, então funciona em todas as edições.

## Quando usar
- Obter a lista de planos de uma edição, como um anúncio, um trailer ou um videoclipe, para refazer ou mudar o estilo plano a plano.
- Salvar uma imagem fixa de cada plano, para usar como imagem de referência em modelos de imagem ou de vídeo.
- Medir o ritmo de uma edição, com a duração de cada plano de relance.
- Encontrar os pontos de corte antes do [**Dividir em partes**](https://nodaro.ai/docs/nodes/video/split-into-chunks). O modo **Planos** dele corta um vídeo nesses mesmos pontos.

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

### Conectar o vídeo
Conecte um vídeo à entrada **Vídeo**, por exemplo a partir de um nó [**Enviar vídeo**](https://nodaro.ai/docs/nodes/video/upload-video).

### Escolher se salva os quadros
Abra o painel de configurações. Ative **Salvar primeiro e último quadro** para salvar um primeiro e um último quadro de cada plano.

### Executar
Clique em **Executar** no nó. O nó mostra o número de planos e o início e o fim de cada um.

Workflow: O Cortes de plano encontra cada plano de um anúncio, e o Extrair campo transforma os planos em uma lista para os próximos nós.

- Enviar vídeo → Cortes de plano (Vídeo)
- Cortes de plano → Extrair campo

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Vídeo** | Nós de vídeo, como Enviar vídeo e Gerar vídeo | O vídeo a medir: MP4, MOV, MKV ou WebM, de até 30 minutos. Obrigatória. |

## Saídas
| Saída | O que leva |
| --- | --- |
| **Planos** | O número de planos, os tempos dos cortes, a duração do vídeo e cada plano, como dados. |
| **Primeiros quadros** | Com os quadros ativados: uma lista com o primeiro quadro de cada plano, como URLs de imagem, na ordem dos planos. |
| **Últimos quadros** | Com os quadros ativados: uma lista com o último quadro de cada plano, como URLs de imagem, na ordem dos planos. |

A saída **Planos** fica assim:

```json
{
"shotCount": 3,
"cutsSec": [2.5, 6.042],
"durationSec": 9,
"shots": [
{ "index": 0, "startSec": 0, "endSec": 2.5, "durationSec": 2.5, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" },
{ "index": 1, "startSec": 2.5, "endSec": 6.042, "durationSec": 3.542, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" },
{ "index": 2, "startSec": 6.042, "endSec": 9, "durationSec": 2.958, "firstFrameUrl": "https://…", "lastFrameUrl": "https://…" }
]
}
```

| Campo | O que significa |
| --- | --- |
| `cutsSec` | Onde cada novo plano começa, em ordem crescente, nunca `0`. Um vídeo com um único plano tem `cutsSec: []` e um plano que cobre o vídeo inteiro. |
| `durationSec` | A duração do vídeo. O último plano termina aí. |
| `startSec`, `endSec` | Segundos a partir do primeiro quadro do vídeo, com precisão de milissegundo. |
| `firstFrameUrl`, `lastFrameUrl` | Imagens PNG, só quando os quadros estão ativados. O último quadro é o quadro logo antes do próximo corte, ou o quadro final do vídeo. Em um plano de um quadro só, o primeiro e o último quadro são a mesma imagem. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Salvar primeiro e último quadro** | Desativado por padrão. Quando ativado, o nó também salva o primeiro e o último quadro de cada plano como imagens. O preço é o mesmo. Os quadros são salvos em vídeos com até 1.000 planos. |

### O que conta como corte
- **Um corte seco** começa um novo plano: um quadro difere bruscamente dos quadros em volta.
- **Transições graduais não são cortes.** Uma fusão ou um fade para preto espalha a mudança por muitos quadros, então os planos dos dois lados contam como um só.
- **Flashes.** Um flash que dura dois ou três quadros e volta à mesma imagem não é um corte. Um flash de um quadro só é um corte.
- **Um corte pode passar despercebido** quando uma segunda grande mudança vem logo depois dele, em até três quadros, como em um chicote de câmera.

## Créditos
O Cortes de plano custa um preço fixo por execução, com ou sem quadros, qualquer que seja a duração do vídeo. O botão **Executar** do nó mostra o preço. As edições auto-hospedadas Community Edition e Business edition não usam créditos.

Estas execuções falham, e os créditos são reembolsados:

- Um arquivo que não é um vídeo legível.
- Um arquivo com mais de cerca de 10,7 GiB. O download para aí.
- Um vídeo com mais de 30 minutos. Corte-o antes.
- Com os quadros ativados, um vídeo com mais de 1.000 planos. Desative os quadros para obter só os tempos, ou corte o vídeo.

## Dicas
- **Leia os tempos de um plano.** Conecte a saída **Planos** a um [**Extrair campo**](https://nodaro.ai/docs/nodes/automate/extract-field), com o campo `shots` e o **Tipo de saída** em **Lista**, ou a um nó de lista. Veja [Listas e lotes](https://nodaro.ai/docs/concepts/lists-and-batching).
- **Refaça um vídeo plano a plano.** Ative os quadros e use o primeiro quadro de cada plano como quadro inicial de um novo clipe.
- **Corte um clipe por plano.** Use o [**Dividir em partes**](https://nodaro.ai/docs/nodes/video/split-into-chunks) no modo **Planos**.
- **Os quadros são exatos.** São os quadros decodificados, salvos sem perda, no tamanho da imagem do vídeo.

## Solução de problemas
| Problema | O que fazer |
| --- | --- |
| A execução falha em um vídeo longo | O Cortes de plano mede vídeos de até 30 minutos. Corte o vídeo antes com o [**Cortar vídeo**](https://nodaro.ai/docs/nodes/video/trim-video). |
| A execução falha com os quadros ativados | O vídeo tem mais de 1.000 planos. Desative **Salvar primeiro e último quadro**, ou corte o vídeo. |
| Dois planos foram contados como um | Os planos estão unidos por uma fusão ou um fade, que não é um corte. Um corte seco logo antes de um chicote de câmera também pode passar despercebido. |
| Um flash começou um novo plano | Um flash de um quadro só conta como corte. Junte os dois planos nas etapas depois do nó. |

## Pela API
O `POST /v1/shot-cuts` com `{ videoUrl, frames? }` coloca uma tarefa na fila e responde com o `jobId` dela. Uma requisição malformada responde `400 validation_error` antes de qualquer crédito ser reservado. O `output_data.json` da tarefa concluída é o resultado **Planos** acima. Com os quadros ativados, `output_data.firstFrames` e `output_data.lastFrames` listam as imagens dos quadros na ordem dos planos.

O método do SDK é `client.media.shotCuts`, e a ferramenta MCP é `shot_cuts`. Veja [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes), [Mídia e uploads no SDK](https://nodaro.ai/docs/developers/sdk/media-and-uploads) e a [Referência das ferramentas MCP](https://nodaro.ai/docs/mcp/tools).

## Perguntas frequentes

### O que o Cortes de plano faz?

O Cortes de plano lê um vídeo e lista os planos dele, com onde cada um começa, onde termina e quanto dura. Ele mede o próprio arquivo, então os tempos batem exatamente com o vídeo.

### O Cortes de plano conta uma fusão ou um fade como corte?

Não. Uma fusão ou um fade para preto espalha a mudança por muitos quadros, então os planos dos dois lados contam como um só. Só um corte seco começa um novo plano.

### Qual é a duração máxima do vídeo?

O Cortes de plano mede vídeos de até 30 minutos, em MP4, MOV, MKV ou WebM. Corte um vídeo mais longo antes.

### O Cortes de plano pode salvar uma imagem fixa de cada plano?

Sim. Ative Salvar primeiro e último quadro. O nó então também salva o primeiro e o último quadro exatos de cada plano como imagens PNG, em vídeos com até 1.000 planos. O preço é o mesmo.

### Quanto custa o Cortes de plano?

O Cortes de plano custa um preço fixo por execução, com ou sem quadros, qualquer que seja a duração do vídeo. O botão Executar do nó mostra o preço.