Verifique a proporção de B-roll e A-roll do seu vídeo
Uma boa edição usa imagens complementares com propósito, mas é difícil avaliar o equilíbrio geral observando apenas trechos isolados da linha do tempo.
Executar grátis
Esta ferramenta transforma as durações totais do material principal e complementar em uma porcentagem clara e a compara com uma faixa de referência adequada ao tipo de conteúdo selecionado. Assim, editores, produtores e revisores ganham um ponto de partida consistente para discutir ritmo, sem tratar uma única proporção como substituta do julgamento editorial.
Meça o material que aparece na edição final
Comece pelo tempo total de tela ocupado pelo A-roll principal e pelo B-roll complementar no corte atual. O A-roll costuma ser a entrevista, o apresentador, a conversa ou a ação central que conduz a narrativa. O B-roll reúne imagens de apoio, como demonstrações, locais, detalhes, arquivos, produtos, planos de cobertura ou elementos gráficos tratados como vídeo. Informe as duas durações em segundos, usando os mesmos limites da linha do tempo e contando apenas o que realmente aparece na edição. Não use a duração de todos os arquivos brutos, pois tomadas não utilizadas aumentariam o resultado indevidamente. A ferramenta soma as durações e divide o B-roll pelo total combinado. Por exemplo, 180 segundos de B-roll em uma edição medida de 600 segundos correspondem a 30 por cento. Em sobreposições, adote uma regra consistente: em uma tela dividida, classifique o intervalo pela imagem predominante e conte-o uma única vez. Isso evita duplicidade e permite comparar versões sucessivas com confiança.
Leia a referência como sinal de ritmo, não como regra criativa
O resultado é comparado com uma faixa ampla definida pelo tipo de conteúdo. Entrevistas normalmente preservam mais tempo de rosto e usam uma faixa menor de B-roll, enquanto tutoriais, documentários e vídeos curtos para redes sociais costumam exigir mais mudanças visuais, demonstrações e contexto. Um valor dentro da faixa indica que o equilíbrio se aproxima desse padrão comum. Um valor abaixo sugere dependência excessiva do plano principal; procure afirmações que precisem de comprovação visual, pausas que peçam cobertura ou trechos em que a atenção diminua. Um valor acima pode indicar que as imagens complementares estão afastando o público do apresentador, da aula ou da ação central. Nenhum desses estados prova que a edição está errada. Uma ótima performance pode sustentar longos trechos de A-roll, e um ensaio visual pode superar justificadamente a faixa documental. Use a diferença em pontos percentuais para dimensionar o desvio e assista à edição em velocidade normal antes de alterá-la. Ritmo, relevância, continuidade emocional, acessibilidade e expectativa do público são mais importantes que atingir uma meta mecanicamente.
Use a proporção durante a revisão e o refinamento
Registre o cálculo para cada versão relevante, em vez de tratá-lo como uma nota única. Montagens iniciais frequentemente trazem longos trechos de A-roll porque as imagens de apoio ainda não foram inseridas. Uma versão posterior pode ir longe demais quando cada frase recebe uma ilustração literal. Comparar a porcentagem entre versões ajuda a equipe a enxergar o que mudou e oferece vocabulário preciso para os comentários. Avaliações por segmento também são úteis: um programa de dez minutos pode ter um total equilibrado, embora um capítulo não ofereça variedade visual e outro esteja carregado de cortes rápidos. Repita o cálculo por capítulo, pessoa ou cena quando o ritmo local for importante. Mantenha o tipo de conteúdo ao comparar versões e registre qualquer exceção intencional. O preço da API é US$ 0,002 por solicitação, portanto o mesmo cálculo determinístico atende relatórios de edição, listas de controle de qualidade e painéis automatizados, além de verificações individuais no navegador.
Casos de uso
Revise a edição de uma entrevista
Meça se cenas de apoio e planos de cobertura oferecem contexto suficiente sem esconder quem fala durante quase toda a narrativa.
Confira a linha do tempo de um tutorial
Compare o apresentador com demonstrações, gravações de tela e detalhes antes da revisão final de ritmo.
Acompanhe as alterações entre versões
Armazene a porcentagem e o estado de referência de cada corte para discutir mudanças de ritmo de forma consistente.
Perguntas frequentes
O que conta como B-roll?
Conte imagens complementares que apoiam ou contextualizam a narrativa principal, incluindo planos de cobertura, demonstrações, locais, detalhes, arquivos e gravações de tela relevantes.
Devo contar material bruto não utilizado?
Não. Meça o tempo de tela da edição analisada, e não a duração total dos clipes disponíveis no projeto.
O que acontece quando as duas durações são zero?
A solicitação retorna um erro de entrada inválida, pois não é possível calcular uma porcentagem com duração total igual a zero.
Um resultado fora da faixa é ruim?
Não necessariamente. Ele é um sinal para revisão, não um veredito de qualidade. História, gênero, performance, relevância visual e público podem justificar outro equilíbrio.
Quanto custa uma solicitação à API?
Cada solicitação à API custa US$ 0,002. O cálculo é determinístico e não usa serviço de rede nem modelo generativo.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/video2/b-roll-ratio-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"a_roll_seconds":420,"b_roll_seconds":180}'const res = await fetch("https://api.kit.forhosting.com/video2/b-roll-ratio-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"a_roll_seconds": 420,
"b_roll_seconds": 180
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video2/b-roll-ratio-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"a_roll_seconds": 420,
"b_roll_seconds": 180
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video2/b-roll-ratio-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"a_roll_seconds":420,"b_roll_seconds":180}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"a_roll_seconds":420,"b_roll_seconds":180}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video2/b-roll-ratio-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"a_roll_seconds": 420,
"b_roll_seconds": 180
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video2.b_roll_ratio_check",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 500 |
max_minutes | 60 |
max_megapixels | 3.9 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |