Posição de marca-d'água em vídeo
Coloque uma logo de 240 por 120 no canto inferior direito de um quadro de 1920 por 1080 com margem de 32 pixels e receba o ponto superior esquerdo, x 1648 e y 928, conferido para caber inteiro no quadro. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Roda direto no seu navegador. Grátis, sem cadastro — seus dados não são enviados para lugar nenhum.
A calculadora de posição de marca-d'água retorna as coordenadas do pixel superior esquerdo necessárias para colocar um logotipo, selo ou elemento de marca em um canto do vídeo. Informe as dimensões do quadro e da imagem, o canto e uma margem uniforme para receber valores x e y determinísticos, prontos para renderização ou codificação. A ferramenta também confirma se toda a imagem cabe no quadro, evitando cortes ou partes ocultas.
Como entender o resultado das coordenadas
Sistemas de composição normalmente localizam uma sobreposição pelo pixel superior esquerdo. Esta calculadora segue essa convenção: x é a distância horizontal a partir da borda esquerda do quadro, e y é a distância vertical a partir da borda superior. No canto superior esquerdo, ambas as coordenadas são iguais à margem solicitada.
No canto superior direito, y continua sendo a margem, enquanto x corresponde à largura do vídeo menos a largura da marca e a margem. As posições inferiores usam a mesma lógica no eixo vertical. Assim, você pode levar o resultado diretamente para um filtro, canvas, modelo gráfico ou pipeline de codificação.
Todos os valores são pixels inteiros, sem posições fracionárias ou arredondamento implícito. A resposta repete a posição e a margem efetiva, facilitando a leitura de registros sem reconstruir a solicitação. A ferramenta calcula apenas geometria: não analisa pixels, não considera preenchimento transparente interno e não altera os arquivos de origem.
Como escolher dimensões e margem seguras
Use as dimensões reais do quadro codificado, e não o tamanho exibido pelo player. Uma fonte de 1920 por 1080 mostrada em um elemento menor ainda usa esse sistema de coordenadas, a menos que a etapa de renderização a redimensione. As dimensões da marca devem representar seu tamanho no momento da sobreposição.
Caso o pipeline redimensione o logotipo, informe a largura e a altura já ajustadas. A margem é um recuo uniforme aplicado nos eixos horizontal e vertical a partir do canto escolhido. O valor zero alinha o retângulo às duas bordas; um valor positivo move a imagem para dentro.
A solicitação é recusada quando a marca excede qualquer dimensão correspondente do quadro ou quando a margem impede seu encaixe completo. Essa validação ajuda em vídeos verticais estreitos, logotipos grandes e automações com proporções variadas. Pixels transparentes continuam pertencendo ao retângulo; remova bordas transparentes desnecessárias se o conteúdo visível parecer distante demais.
Como aplicar as coordenadas em produção
Insira x e y na etapa de sobreposição depois que qualquer redimensionamento ou normalização de orientação terminar. A ordem é importante: calcular para um quadro horizontal e depois girar ou cortar o vídeo pode mudar o canto visual ou tirar a marca da tela. Faça o cálculo com a geometria final ou recalcule sempre que uma transformação alterar largura ou altura.
Em lotes, mantenha canto e margem como regras e forneça as dimensões reais de cada arquivo. A resposta determinística preserva o mesmo espaçamento em formatos horizontais, quadrados, verticais e personalizados. Esta capacidade não considera áreas seguras, recortes de dispositivos, legendas, geradores de caracteres ou assuntos importantes; escolha margem maior ou outro canto quando houver restrições editoriais.
Ela também não cria expressões específicas de um codificador, portanto as coordenadas continuam portáveis entre ferramentas.
Casos de uso
Montar um comando de codificação
Calcule valores x e y portáveis antes de inserir um logotipo em uma tarefa de transcodificação ou renderização.
Padronizar exportações da marca
Aplique a mesma regra de canto e margem a versões de vídeo horizontais, quadradas e verticais.
Validar layouts automatizados
Recuse marcas grandes demais ou margens impossíveis antes de iniciar uma etapa cara de processamento.
Perguntas frequentes
O que x e y representam?
São as coordenadas do canto superior esquerdo do retângulo da marca, medidas a partir do canto superior esquerdo do vídeo.
Como a margem é aplicada?
A mesma margem não negativa em pixels é aplicada para dentro nas bordas horizontal e vertical do canto selecionado.
O que ocorre se a marca for maior que o vídeo?
A solicitação retorna um erro de entrada inválida, pois a imagem não pode caber inteiramente no quadro.
A marca pode encostar na borda?
Sim. Defina a margem como zero para alinhar seu limite retangular às duas bordas do canto escolhido.
A ferramenta redimensiona ou adiciona a marca ao vídeo?
Não. Ela apenas calcula a posição; não envia, decodifica, redimensiona, renderiza ou modifica mídia.
Ferramentas relacionadas
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/watermark-position \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"video_width":1920,"video_height":1080,"watermark_width":240,"watermark_height":120,"position":"bottom_right"}'const res = await fetch("https://api.kit.forhosting.com/video/watermark-position", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"video_width": 1920,
"video_height": 1080,
"watermark_width": 240,
"watermark_height": 120,
"position": "bottom_right"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/video/watermark-position",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"video_width": 1920,
"video_height": 1080,
"watermark_width": 240,
"watermark_height": 120,
"position": "bottom_right"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/video/watermark-position", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"video_width":1920,"video_height":1080,"watermark_width":240,"watermark_height":120,"position":"bottom_right"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"video_width":1920,"video_height":1080,"watermark_width":240,"watermark_height":120,"position":"bottom_right"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/video/watermark-position", 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_width": 1920,
"video_height": 1080,
"watermark_width": 240,
"watermark_height": 120,
"position": "bottom_right"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "video.watermark_position",
"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. |
Notas técnicas
Como aplicar as coordenadas em produção
Cada cálculo pela API custa US$ 0,002; a versão no navegador executa localmente a mesma aritmética para planejamento e conferência.
Perguntas técnicas
Quanto custa uma solicitação da API?
Cada solicitação da API custa US$ 0,002. O mesmo cálculo determinístico também pode ser executado no navegador.