ForHosting KIT · Vídeo

Calcular corte de vídeo pela proporção da tela

Adaptar um vídeo a outro formato de tela começa com uma pergunta objetiva: qual retângulo centralizado preserva a maior área possível e corresponde à proporção de destino?

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

Esta calculadora recebe a largura e a altura em pixels do vídeo original e uma proporção como 9:16, 1:1 ou 16:9. Ela devolve a origem e as dimensões do corte sem enviar, decodificar, redimensionar ou alterar o vídeo. Você pode fornecer essa geometria diretamente a um fluxo de edição, comando de transcodificação, pipeline de mídia ou interface de pré-visualização.

Converta o quadro original no maior corte compatível

Informe a largura e a altura em pixels do vídeo decodificado e indique a proporção de destino no formato largura para altura, com dois-pontos entre os valores. Por exemplo, 1920 por 1080 representa um quadro horizontal comum, enquanto 9:16 solicita um resultado vertical adequado a vídeos curtos em dispositivos móveis. A calculadora compara a proporção original com a solicitada e preserva a dimensão que já limita o encaixe. Se a origem for larga demais, ela mantém toda a altura e reduz a largura. Se for alta demais, mantém toda a largura e reduz a altura. Assim, produz o maior retângulo que cabe no quadro sem esticar, adicionar preenchimento ou ultrapassar as bordas. Os valores x e y localizam o canto superior esquerdo, e width e height descrevem o tamanho. Juntos, eles formam uma área de corte completa para cada quadro de um vídeo com resolução constante. Nenhum byte de mídia é necessário, pois somente a geometria do quadro participa do cálculo.

Entenda as coordenadas centrais e os pixels fracionários

Um corte centralizado remove a mesma quantidade de bordas opostas. Quando uma origem horizontal precisa ficar mais estreita, x corresponde à metade da área horizontal descartada e y permanece em zero. Quando o quadro precisa ficar mais baixo, y corresponde à metade da área vertical descartada e x permanece em zero. Algumas combinações de dimensões e proporções geram coordenadas ou tamanhos fracionários. Isso é proposital: o centro matemático exato ou a proporção solicitada podem ficar entre limites físicos de pixels. A geometria decimal evita escolher silenciosamente uma regra de arredondamento incompatível com seu codificador, sua biblioteca gráfica ou seu aplicativo de edição. Os valores são normalizados em nove casas decimais para manter solicitações repetidas estáveis e impedir que ruídos de ponto flutuante cheguem a manifestos ou testes. Se a ferramenta seguinte aceitar somente inteiros, aplique a política de arredondamento documentada durante a integração e confira as dimensões finais codificadas.

Use o corte com segurança na produção de vídeo

Trate a resposta como geometria reutilizável, não como um vídeo transformado. Passe x, y, width e height à etapa de corte do seu transcodificador, editor não linear, renderizador canvas, gerador de miniaturas ou serviço de mídia. Confirme que a ferramenta receptora usa a origem no canto superior esquerdo, com x aumentando para a direita e y para baixo, conforme a convenção adotada aqui. Obtenha a largura e a altura do fluxo de vídeo realmente decodificado, não do nome do arquivo, da janela do player ou de um cadastro desatualizado. Gravações de celular podem conter metadados de orientação; defina se o pipeline aplica essa rotação antes ou depois do corte e forneça dimensões da mesma etapa. O analisador aceita somente dois componentes numéricos positivos e finitos separados por dois-pontos. Erros, separadores alternativos, zeros, negativos e texto adicional são rejeitados em vez de interpretados. Em lotes automatizados, esse rigor impede a geração de muitos resultados com enquadramento incorreto.

Adapte vídeo horizontal a canais verticais

Calcule a maior região centralizada em 9:16 antes de codificar versões específicas de cada plataforma a partir de um arquivo horizontal.

Padronize o enquadramento de miniaturas

Use um único cálculo determinístico para prévias e miniaturas que precisam preencher um player fixo sem bordas.

Valide uma predefinição automática de transcodificação

Visualize as coordenadas a partir dos metadados e rejeite proporções inválidas antes do processamento caro da mídia.

Esta ferramenta envia ou modifica o vídeo?

Não. Ela usa somente largura, altura e proporção para devolver geometria; não recebe, decodifica, armazena nem transforma mídia.

Quanto custa o cálculo?

O preço da API é US$ 0,002 por solicitação. O mesmo cálculo determinístico também pode ser executado no navegador.

Qual sintaxe de proporção é aceita?

Use dois números positivos separados por dois-pontos, como 9:16, 16:9, 1:1 ou 1.85:1. Outros separadores e textos extras são inválidos.

Por que o corte pode ter valores decimais?

O centro ou a proporção exata podem ficar entre pixels. A geometria decimal preserva o maior corte central sem impor arredondamento.

O corte pode ultrapassar o quadro original?

Não. Uma dimensão sempre coincide com a dimensão original correspondente, e a outra é reduzida para atender à proporção solicitada.

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/aspect-ratio-crop

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/aspect-ratio-crop \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":1920,"height":1080,"ratio":"9:16"}'
{
  "width": 1920,
  "height": 1080,
  "ratio": "9:16"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "video.aspect_ratio_crop",
  "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_mb500
max_minutes60
max_megapixels3.9
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 →