Cortes de plano

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 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. O modo Planos dele corta um vídeo nesses mesmos pontos.

Início rápido

Entradas

Saídas

A saída Planos fica assim:

{
  "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://…" }
  ]
}

Configurações

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, com o campo shots e o Tipo de saída em Lista, ou a um nó de lista. Veja Listas e lotes.
• 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 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

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ó, Mídia e uploads no SDK e a Referência das ferramentas MCP.