ForHosting KIT · Vídeo

Qual é o codec desse vídeo?

Lê os dados técnicos de um arquivo de vídeo — codec, resolução, duração, taxa de quadros, bitrate e faixas de áudio — e devolve tudo em JSON estruturado. Serve para quem precisa conferir o que um vídeo é por dentro antes de publicar, converter ou aceitar o upload.

● Estávelpor vídeoUS$ 0,077

Executar — US$ 0,077 + US$ 0,0045/vídeo Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

O vídeo que não abre sempre deixa pista

Quando um vídeo não toca no site, trava no player do celular ou é recusado por uma plataforma, a causa quase nunca é misteriosa: é um codec que o navegador não decodifica, uma resolução fora do esperado ou um contêiner exótico. O problema é que essas informações ficam escondidas — o Windows mostra pouco, o celular mostra menos. Esta tarefa abre o arquivo por dentro e responde a pergunta técnica de uma vez, sem você instalar programa nenhum.

O que vem no relatório

A resposta chega em JSON com os campos que importam: contêiner e codec de vídeo, codec de áudio, resolução em pixels, duração exata, taxa de quadros, bitrate e a lista de faixas presentes no arquivo. Por ser um dado estruturado, dá para ler no navegador ou consumir direto no seu sistema — comparar contra uma regra, gravar num banco, exibir num painel. O arquivo original sai da análise intacto: nada é convertido nem regravado.

Validar uploads antes de aceitar

O uso mais rentável é automático: uma plataforma que recebe vídeos de usuários chama a análise no momento do upload e decide na hora se aceita o arquivo. Fora do padrão? A pessoa recebe um aviso claro — “envie em MP4, no máximo 1080p” — em vez de descobrir dias depois que o vídeo não roda. O mesmo vale para quem recebe material de terceiros: conferir a peça antes de aprovar evita retrabalho de gravação.

Preço fixo por arquivo e fase atual

A cobrança é por vídeo analisado, não por minuto: US$ 0,077 pela chamada mais US$ 0,0045 por arquivo — cerca de US$ 0,08, faça o vídeo 2 ou 60 minutos, até os limites de 500 MB e uma hora de duração. Sem mensalidade e sem pacote mínimo: você paga pelo que rodar. A capacidade está em fase de implantação, com preço e comportamento já publicados; o envio de tarefas abre em breve.

Casos de uso

Upload de terceiros sob controle

Rafael Almeida Costa mantém um portal que recebe vídeos de anunciantes. A análise roda em cada upload e barra na hora arquivos fora do padrão, com mensagem explicando o que corrigir.

Produtora conferindo material de cliente

Uma produtora de Belo Horizonte recebe gravações brutas de clientes por link. Antes de agendar a edição, confere codec, resolução e fps de cada arquivo — e devolve na hora o que veio errado.

Catálogo de vídeos com ficha técnica

A Distribuidora Horizonte Verde arquiva vídeos de treinamento de vários fornecedores. O JSON de cada arquivo alimenta o inventário: duração e resolução aparecem na listagem sem ninguém abrir vídeo por vídeo.

Diagnóstico de vídeo que não roda

O site da TecnoSul Soluções Digitais exibia um vídeo institucional que não abria no iPhone. A análise revelou o codec incompatível em segundos — bastou converter para resolver.

Perguntas frequentes

Quais informações a análise devolve?

Codec de vídeo e de áudio, contêiner, resolução, duração, taxa de quadros, bitrate e as faixas presentes no arquivo — tudo em JSON estruturado.

Preciso enviar o vídeo inteiro só para ver o codec?

Sim, a análise trabalha sobre o arquivo enviado, respeitando o limite de 500 MB. Em troca, você recebe a ficha técnica completa, não só o codec.

Serve para descobrir por que o vídeo não toca no site?

É o uso clássico: a maioria dos vídeos que não abrem usa codec ou contêiner que o navegador não suporta, e o relatório mostra isso de cara.

Quanto custa analisar um arquivo?

US$ 0,077 pela chamada mais US$ 0,0045 pelo vídeo — cerca de US$ 0,08 por análise, em dólares, independentemente da duração.

O arquivo enviado é alterado ou reaproveitado?

Não. A leitura é somente de metadados: o vídeo não é convertido, não é publicado e não é usado para nenhum outro fim além da sua tarefa.

O envio já está liberado?

Ainda não — a capacidade está em implantação. As condições publicadas nesta página são as que valerão quando as execuções abrirem.

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/metadata

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/video/metadata \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/video/metadata",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

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

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

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.metadata",
  "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 vídeoUS$ 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 →