ForHosting KIT · Vídeo

Calcule tempos uniformes para miniaturas de vídeo

Planeje um conjunto limpo de imagens de prévia antes de decodificar qualquer quadro.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe a duração do vídeo e a quantidade de miniaturas desejada, e esta calculadora retornará tempos determinísticos e uniformemente espaçados em segundos. Ela evita de propósito o primeiro e o último segundo, onde fades, quadros vazios, cartelas de abertura e telas finais costumam gerar prévias ruins. O resultado fica pronto para um comando de extração, pipeline de mídia, gerador de storyboard ou linha do tempo de um player.

Escolha pontos representativos sem capturar as bordas

Um conjunto útil de miniaturas deve resumir o vídeo, e não apenas dividir sua duração bruta. O instante inicial muitas vezes contém um quadro preto, um fade de entrada, uma cartela de carregamento ou um quadro-chave incompleto. No final, também podem aparecer fade, créditos, tela de encerramento ou nenhum quadro decodificável exatamente no limite da duração. A calculadora remove essas regiões pouco confiáveis ao definir uma janela útil que começa um segundo após o início e termina um segundo antes do fim. Ao solicitar dois ou mais tempos, ela posiciona o primeiro no começo dessa janela segura, o último no final e distribui os demais em intervalos iguais. Para uma única miniatura, retorna o ponto central do vídeo. O comportamento é explícito e reproduzível: a mesma duração e quantidade sempre produzem o mesmo plano. Assim, você pode enviar os segundos diretamente a outro processo de extração sem reimplementar a distribuição nem solicitar por engano o ponto final inacessível do arquivo de mídia.

Entenda o cálculo e os limites

A entrada usa segundos e aceita durações fracionárias, o que importa porque metadados de mídia raramente terminam em um segundo inteiro. Para várias miniaturas, o espaçamento é a duração útil —a duração total menos dois segundos— dividida por uma unidade a menos que a quantidade solicitada. Cada tempo corresponde ao primeiro segundo seguro somado a esse intervalo multiplicado pela posição iniciada em zero. Os resultados são arredondados para no máximo seis casas decimais, mantendo a saída JSON estável e preservando precisão de frações de segundo. A duração precisa ser superior a dois segundos, pois um clipe menor não deixa intervalo capaz de excluir as duas bordas. A quantidade deve ser um inteiro de pelo menos um; zero ou valores negativos não formam um plano válido e causam erro de entrada. Os limites máximos evitam listas grandes sem necessidade. Esta ferramenta calcula posições somente: ela não examina quadros, detecta cenas, localiza quadros-chave nem garante que um decodificador alcance exatamente a fração solicitada.

Use os tempos no seu fluxo de miniaturas

Comece pela duração confiável informada pela sua sonda de mídia, pelos metadados do player ou pelo serviço de upload. Escolha uma quantidade adequada ao destino: uma prévia compacta ao percorrer a linha do tempo pode precisar de poucos quadros, enquanto um storyboard longo pode exigir dezenas. Envie os valores à calculadora e preserve a ordem retornada na extração das imagens. A maioria das ferramentas de vídeo aceita tempos em segundos ou consegue convertê-los para sua própria notação. Como o plano é uniforme, ele também funciona em chaves de cache determinísticas e tarefas repetíveis: uma nova tentativa solicitará as mesmas posições. Lembre que a precisão final depende do extrator. Alguns modos rápidos pulam para um quadro-chave próximo; modos precisos decodificam até o tempo pedido. Para uma cobertura sensível ao conteúdo, use detecção de cenas. Para cobertura previsível da linha do tempo, processamento em lote, testes e faixas de prévia, estes tempos fornecem um contrato simples, transparente e reproduzível.

Monte uma faixa de prévias

Gere posições previsíveis para as imagens exibidas quando uma pessoa percorre a linha do tempo do vídeo.

Planeje um storyboard

Crie uma folha de contatos com amostragem uniforme sem escolher quadros pretos de abertura ou telas finais.

Programe extração em lote

Envie uma lista estável de tempos para uma tarefa do FFmpeg, worker de mídia ou pipeline de uploads.

Quanto custa?

Cada solicitação de API custa US$ 0,002. Você também pode usar a calculadora no navegador.

Por que o primeiro e o último segundo são excluídos?

Essas regiões costumam conter fades, quadros vazios, cartelas, créditos ou um limite impossível de decodificar e, por isso, geram prévias ruins.

O que acontece ao pedir uma miniatura?

A calculadora retorna o ponto central do vídeo, que fica na janela segura em toda duração aceita.

Esta ferramenta extrai as imagens?

Não. Ela retorna apenas os tempos; use o resultado com um decodificador ou extrator de quadros.

Há suporte para frações de segundo?

Sim. A duração e os tempos podem ter frações, com a saída arredondada para no máximo seis casas decimais.

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.

POSThttps://api.kit.forhosting.com/video/thumbnail-timestamps

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/video/thumbnail-timestamps \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_seconds":120,"count":5}'
{
  "duration_seconds": 120,
  "count": 5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.thumbnail_timestamps",
  "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.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_items10000
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →