Análise e listas de edição

As ferramentas de análise e listas de edição leem gravações existentes e as transformam em dados estruturados ou em montagens prontas. video_analysis e video_audit decompõem um vídeo cena a cena para que ele possa ser recriado, silence_detect e audio_sync medem gravações, e plan_edit e apply_edl planejam e renderizam cortes a partir de uma transcrição. Todas as ferramentas precisam da permissão workflows:execute e retornam um ID de job.

video_analysis

Analisa um vídeo e o decompõe cena a cena, num formato feito para a recriação com IA. Funciona como o nó Análise de vídeo (Video Analysis).

• As cenas são cortadas nos limites naturais e duram no máximo 8 segundos: uma geração de imagem ou de vídeo por cena.
• visualResolved é uma descrição autônoma de cada cena, pronta para usar como prompt. É o campo que as etapas seguintes leem.
• Cada cena também tem um enquadramento, um movimento de câmera e uma lista de camadas de áudio. A fala é citada palavra por palavra, a música e os efeitos sonoros são descritos para que possam ser gerados, e uma lista vazia significa silêncio.
• Os slots são as pessoas, os objetos e os lugares recorrentes, para que você possa substituí-los pelos seus próprios personagens.

Permissão: workflows:execute. Créditos: conforme o nível e a duração do vídeo, na tabela abaixo.

Retorna: um ID de job. A análise, com meta, slots e scenes, fica no output_data do job.

O preço depende do nível e da faixa de duração, a menor entre 60, 180, 360 ou 600 segundos que comporta o vídeo. As faixas de 60, 180 e 360 segundos têm 3 segundos de tolerância cada uma, então um vídeo de até 1:03 é cobrado na faixa de 60 segundos:

list_models retorna os preços atuais.

video_audit

Assiste a um vídeo de novo, comparando-o com a análise dele, e corrige o que estiver errado. Cada correção é aplicada com verificações e informada, e o que não pôde ser corrigido é sinalizado, não alterado. Funciona como o nó Auditoria com IA (AI Audit).

Permissão: workflows:execute. Créditos: conforme a duração, e mais barato quando você passa uma análise.

Retorna: um ID de job. O output_data do job contém o relatório: o que foi verificado, o que mudou e o que ficou em aberto.

silence_detect

Encontra os trechos de silêncio de uma gravação só pelo áudio: sem transcrição e sem imagens. Funciona como o nó Detectar silêncio (Silence Detect).

Permissão: workflows:execute. Créditos: 11.

Retorna: um ID de job. O resultado é output_data.json, { ranges, durationMs }. Passe esse objeto, e não o output_data inteiro, como o silence de plan_edit, ou use ranges para escrever uma lista de edição à mão.

audio_sync

Mede a defasagem entre os relógios de 2 a 6 gravações de uma mesma conversa, como os arquivos das câmeras e um microfone principal, comparando o áudio delas. Funciona como o nó Sincronizar áudio (Audio Sync).

Permissão: workflows:execute. Créditos: de 11 com 2 origens a 55 com 6, conforme o número de gravações alinhadas à referência.

Retorna: um ID de job. O resultado é output_data.json: { reference, offsets, notes }, em que cada deslocamento tem sourceId, offsetMs, confidence e driftMsPerHour. Um instante no relógio da referência é o instante na origem mais offsetMs. Confiança baixa e desvio de relógio são informados em notes, nunca corrigidos.

plan_edit

Transforma uma transcrição com marcação de tempo numa lista de decisões de edição para uma gravação. Ela lê a transcrição, nunca as imagens. Funciona como o nó Plano de edição (Edit Plan).

Permissão: workflows:execute. Créditos: de 33 a 1.628, conforme a duração da gravação, o modo e o nível. Somente no Nodaro Cloud.

A origem mestre é a que tem a função master-audio ou, se nenhuma tiver, a primeira origem. A ferramenta recusa a chamada antes de qualquer cobrança quando os deslocamentos deixariam o corte fora de sincronia:

• Uma origem não tem offset_ms, e o audio_sync não a mediu ou teve uma correspondência fraca com ela, com confiança menor que 0,5. Defina o offset_ms dela.
• A origem mestre tem um offset_ms diferente de 0.
• Outras origens usam deslocamentos medidos, mas o audio_sync não mediu a origem mestre, ou a correspondência dela é fraca.
• offsets não é um resultado do audio_sync, ou uma origem não tem id para a associação.
• A transcrição foi feita a partir de uma origem fora do relógio da origem mestre. Transcreva a origem mestre ou dê a essa origem a função master-audio.

Retorna: um ID de job. O plano fica no output_data do job, pronto para apply_edl.

apply_edl

Renderiza uma lista de decisões de edição numa montagem pronta. Funciona como o nó Aplicar EDL (Apply EDL), cuja página também informa o preço por minuto.

Permissão: workflows:execute. Créditos: cobrados por minuto de saída renderizada.

Uma renderização pode produzir no máximo 180 minutos. Uma lista malformada, ou longa demais, é recusada antes que qualquer coisa seja executada, com o segmento e a regra que ele viola.

Retorna: um ID de job. O arquivo renderizado é o resultado do job.

Editar uma gravação a partir da transcrição

A receita podcast-editing conduz um assistente pelas mesmas etapas; veja Receitas de conteúdo. Com várias câmeras e um microfone separado, execute audio_sync primeiro e passe o offset_ms de cada origem para plan_edit.