ForHosting KIT · Vídeo

Extrair frames de vídeo

Extrai quadros (frames) de um vídeo e devolve cada um como imagem separada. Serve para documentar uma sequência, escolher a melhor cena de uma gravação, montar storyboard ou alimentar um sistema que analisa imagens. Você define o vídeo e o ritmo; o preço é por minuto processado.

Em brevepor minutoUS$ 0,077

Esta tarefa não está disponível no momento, portanto não pode ser contratada. Nada é cobrado por ela.

Ver a API

Use pelo Web somente APIAPIE-mailTelegramApp em breve

Para que fatiar um vídeo em imagens

Um vídeo é uma pilha de fotografias em sequência, e há situações em que as fotografias valem mais que o filme: documentar o estado de uma obra ao longo de uma vistoria gravada, escolher a melhor pose num vídeo de produto, analisar o momento exato de um incidente registrado por câmera, montar o storyboard de um material bruto. Extrair frames transforma a linha do tempo em um conjunto de imagens que você examina, compara e arquiva uma a uma.

Como funciona a extração

Você envia o vídeo pela API com a instrução de extração e recebe um task_id; a tarefa roda de forma assíncrona e devolve os quadros como imagens individuais. Dá para trabalhar um trecho específico — cortando o vídeo antes com a capacidade de corte do KIT — ou o arquivo inteiro, respeitando os limites de 500 MB e 60 minutos. O resultado chega pronto para revisar, anexar a um laudo ou alimentar outro sistema.

Escolha o intervalo com critério

Um vídeo comum carrega dezenas de quadros por segundo: extrair todos de uma gravação longa gera dezenas de milhares de imagens — quase nunca é o que você quer. Para documentação, um quadro por segundo costuma bastar; para análise fina de um lance, vale extrair denso, mas de um trecho curto. Definir bem o intervalo é a diferença entre uma pasta útil e um caos de arquivos repetidos. De qualquer forma, cada chamada devolve no máximo 300 quadros — a um quadro por segundo, cerca dos primeiros cinco minutos do vídeo —, então vale escolher o intervalo para cobrir o trecho que importa.

Preço por minuto e status

A extração custa US$ 0,077 por chamada mais US$ 0,0045 por minuto de vídeo processado, em dólares — fatiar dez minutos custa US$ 0,122. Cada execução é avulsa, sem plano nem cadastro. A capacidade está em fase de implantação: as execuções ainda não foram abertas, e esta página publica desde já as condições reais de lançamento.

Casos de uso

Vistoria de obra documentada

Um engenheiro de Porto Alegre grava em vídeo a vistoria da obra e extrai um quadro por segundo dos trechos críticos. As imagens numeradas entram no relatório técnico como registro da sequência.

Foto de produto sem sessão nova

A Distribuidora Horizonte Verde grava cada produto girando e extrai os quadros para escolher os melhores ângulos — a página do item ganha fotos sem agendar novo ensaio.

Análise de trecho de câmera

O síndico de um condomínio em Recife extrai os frames do minuto em que ocorreu uma colisão na garagem. Quadro a quadro, a sequência mostra com clareza como o dano aconteceu.

Storyboard do material bruto

Uma editora de vídeo de São Paulo fatia as gravações do dia em quadros-chave e monta o storyboard da edição num mural, antes de abrir o projeto pesado.

Perguntas frequentes

Quantas imagens vou receber?

Cada chamada devolve no máximo 300 imagens: a um quadro por segundo, isso cobre cerca de cinco minutos de vídeo; num ritmo mais denso, o teto de 300 é atingido antes. Planeje o ritmo de extração conforme o uso.

A ferramenta escolhe o melhor quadro sozinha?

Não — ela extrai conforme a sua instrução, sem curadoria automática. A previsibilidade é proposital: você recebe exatamente o que pediu e faz a seleção com seus critérios.

Como funciona o pagamento em dólar?

O preço é publicado em US$ e a cobrança passa pelo PayPal, que converte para reais no ato com o câmbio do dia. Sem cadastro no site e sem assinatura.

Frames com rostos de pessoas: e a LGPD?

As imagens extraídas são entregues somente a você, dentro da tarefa. O uso posterior — divulgar, anexar, arquivar — segue sob sua responsabilidade como controlador dos dados.

Qual o limite por vídeo?

500 MB e 60 minutos por arquivo. Para gravações maiores, divida antes e extraia por partes.

Posso usar agora?

Ainda não: a capacidade está em fase de implantação. Quando as execuções abrirem, valem o preço e os limites já publicados aqui.

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

POSThttps://api.kit.forhosting.com/video/frames

One authenticated POST creates the task; the result comes back by webhook or a signed link. This capability is currently available through the API, not as an interactive Web tool.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/video/frames \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video":"https://example.com/clip.mp4"}'

const res = await fetch("https://api.kit.forhosting.com/video/frames", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "video": "https://example.com/clip.mp4"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/frames",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "video": "https://example.com/clip.mp4"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/frames", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"video":"https://example.com/clip.mp4"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"video":"https://example.com/clip.mp4"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/frames", 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

{
  "video": "https://example.com/clip.mp4"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.frames",
  "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

por chamadaUS$ 0,077

por minutoUS$ 0,0045

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.

Ver a documentação completa do KIT →