Verifique a proporção do vídeo para cada plataforma
Um vídeo pode ser tecnicamente válido e ainda assim se encaixar mal no destino. Este verificador compara a proporção entre largura e altura informada com o quadro fixo de uma posição específica em uma plataforma social.
Executar grátis
Ele indica se a geometria corresponde, se uma fonte mais estreita precisaria de barras laterais ou se uma fonte mais larga perderia as bordas por corte. Nenhum vídeo é enviado ou decodificado: informe a proporção, a plataforma e o canal para receber uma resposta determinística útil no planejamento, na validação ou em um fluxo automatizado de publicação.
Escolha o destino antes de avaliar a origem
A conformidade da proporção pertence ao canal, não apenas ao nome da plataforma. Um vídeo comum do YouTube usa um quadro horizontal, enquanto Shorts usa um quadro vertical. O Instagram também separa feed em retrato, feed quadrado, Reels e Stories. Selecione exatamente o par que representa onde o material aparecerá e informe a proporção exibida no formato largura:altura, como 16:9, 9:16, 4:5 ou 1:1. Componentes decimais são aceitos para formatos menos usuais. O verificador converte os rótulos de plataforma e canal em minúsculas, consulta o quadro declarado e compara os dois valores. Ele não examina nome de arquivo, resolução, metadados de rotação nem o fluxo codificado. Caso uma gravação de celular tenha orientação em metadados, descubra as dimensões depois da rotação e envie a proporção realmente exibida. Combinações desconhecidas são rejeitadas de forma explícita, impedindo que uma automação aplique uma regra de feed a um story ou tome emprestada a convenção de outra plataforma.
Entenda correspondência, barras e corte
O resultado de correspondência informa que origem e destino têm a mesma forma matemática dentro de uma tolerância mínima de ponto flutuante. Nenhuma adaptação geométrica é necessária. O resultado de barras indica que a origem é mais estreita que o quadro de destino. Preservar toda a imagem deixa espaço livre nas laterais, normalmente chamado de pillarbox, embora a API utilize a categoria geral letterboxed. O resultado de corte indica que a origem é mais larga. Preencher o quadro em toda a altura removeria conteúdo das bordas esquerda e direita. Esses rótulos descrevem um encaixe geométrico centralizado, não uma garantia do comportamento de cada aplicativo. Uma plataforma pode oferecer reenquadramento manual, fundo desfocado, várias proporções aceitas ou mudar o produto. Use a resposta para identificar a necessidade de revisão editorial. Em caso de corte, confira pessoas, legendas, marcas e elementos próximos às laterais. Em caso de barras, decida se um fundo planejado é melhor do que áreas vazias simples.
Faça a verificação antes de publicar
Execute a verificação assim que o destino for definido, antes de gastar tempo com renderização final, envio ou revisão de mídia. Um sistema de conteúdo pode guardar a plataforma e o canal pretendidos junto ao material, calcular a proporção exibida com metadados confiáveis e chamar esta capacidade como etapa de validação. Correspondências podem seguir automaticamente. Resultados com barras ou corte podem abrir uma tarefa de revisão, selecionar uma versão alternativa pronta ou encaminhar o material para um cálculo separado de corte. Guarde required_ratio no registro de auditoria para que a equipe saiba qual alvo motivou a decisão. A resposta também repete plataforma, canal e proporção normalizados, facilitando a leitura dos logs quando uma origem atende vários destinos. A capacidade não redimensiona pixels, calcula áreas seguras, prevê compressão nem afirma que o upload será rejeitado. Pela API, cada verificação determinística custa US$ 0,002, sem transferência do arquivo de vídeo.
Casos de uso
Valide materiais antes do agendamento
Sinalize um formato incompatível antes que a fila envie o vídeo ao canal escolhido.
Escolha a versão correta
Compare a origem com o destino e encaminhe o trabalho para uma versão horizontal, quadrada, retrato ou vertical.
Crie uma regra de revisão editorial
Envie cortes para conferir as bordas e resultados com barras para definir fundo ou composição.
Perguntas frequentes
O que significa uma correspondência?
A proporção informada tem a mesma forma numérica que o requisito salvo para a plataforma e o canal.
Por que o resultado indica barras?
A origem é mais estreita que o quadro; preservá-la inteira deixaria barras ou outro tratamento de fundo nas laterais.
O que significa corte neste resultado?
A origem é mais larga que o destino, portanto um preenchimento central removeria partes dos lados esquerdo e direito.
A ferramenta envia ou edita o vídeo?
Não. Ela só compara proporções e não recebe, decodifica, armazena, redimensiona, corta nem transcodifica mídia.
Quanto custa uma verificação pela API?
Cada solicitação de API custa US$ 0,002. Não existe tarifa variável de mídia porque o vídeo não é transferido.
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/video/video-aspect-platform-check \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"ratio":"16:9","platform":"youtube","placement":"video"}'const res = await fetch("https://api.kit.forhosting.com/video/video-aspect-platform-check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/video-aspect-platform-check",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/video-aspect-platform-check", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"ratio":"16:9","platform":"youtube","placement":"video"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"ratio":"16:9","platform":"youtube","placement":"video"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/video-aspect-platform-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
{
"ratio": "16:9",
"platform": "youtube",
"placement": "video"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.video_aspect_platform_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. |