ForHosting KIT · Imagens

Redimensionar imagem para redes sociais

Preparar uma imagem para várias redes sociais exige mais do que alterar seu tamanho: é preciso escolher o enquadramento correto.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Esta calculadora recebe a largura e a altura de origem, além de uma plataforma e um posicionamento compatíveis, e retorna o maior corte central na proporção exigida. Ela também informa as dimensões do formato e quanto será removido de cada borda. Nenhuma imagem é enviada, decodificada ou modificada. Você pode reutilizar as coordenadas em editores, bibliotecas gráficas, scripts, pipelines ou telas de pré-visualização.

Escolha o destino antes de calcular o corte

Informe a largura e a altura reais da imagem em pixels e selecione a plataforma e o posicionamento de destino. Uma publicação do Instagram, um story, um cabeçalho do Twitter e um banner do LinkedIn usam molduras muito diferentes, mesmo quando partem da mesma fotografia. A calculadora combina os campos, consulta as dimensões conhecidas e determina a proporção. Em seguida, encontra o maior retângulo com essa proporção que cabe integralmente na origem. Se a imagem for larga demais, mantém toda a altura e remove faixas iguais à esquerda e à direita. Se for alta demais, mantém toda a largura e corta em cima e embaixo. A resposta apresenta plataforma e posicionamento normalizados, nome do formato, dimensões de destino, proporção numérica, retângulo de corte e margens removidas. Assim, você pode montar uma prévia ou aplicar a decisão por software sem manter outra tabela de dimensões sociais.

Entenda o significado das coordenadas

O objeto de corte usa a origem comum no canto superior esquerdo: x aumenta para a direita e y para baixo. A largura e a altura descrevem a região da origem que deve permanecer, não a resolução final exportada. O objeto de margens apresenta a mesma decisão como quantidades retiradas dos quatro lados, algo útil em interfaces e registros. Como o corte é central, margens opostas são iguais. Certas combinações geram coordenadas decimais, pois o centro ou a proporção exata podem ficar entre pixels. Preservar a precisão evita impor um arredondamento diferente daquele adotado por Sharp, ImageMagick, Canvas ou outro serviço. Caso sua ferramenta aceite apenas inteiros, aplique no fim a regra documentada por ela. Depois do corte, redimensione a região preservada para as dimensões de destino se a plataforma exigir esses valores. Esta capacidade calcula apenas a geometria; ela não estica, preenche, reamostra nem altera dados da imagem.

Use formatos estritos para uma publicação previsível

O nome da plataforma não basta, porque cada rede oferece posicionamentos com formatos diferentes. Por isso, a calculadora aceita somente combinações explícitas de plataforma e posicionamento. Uma combinação desconhecida gera um erro de entrada, sem tentar adivinhar uma proporção ou usar um quadrado genérico. Esse comportamento protege automações: um destino digitado incorretamente interrompe o trabalho antes da criação de centenas de peças erradas. Armazene o formato e as dimensões retornados com o arquivo gerado para registrar qual regra foi aplicada. Sempre confira uma prévia central quando o assunto estiver perto da borda, pois um cálculo matematicamente correto não sabe qual rosto, logotipo, produto ou texto é mais importante. Nesse caso, preserve a largura e a altura válidas, mas permita que um editor mova x ou y dentro da origem. Não há rede, relógio, aleatoriedade, análise visual nem estado oculto; entradas idênticas sempre produzem resultados idênticos.

Casos de uso

Prepare uma campanha para várias redes

Calcule uma moldura central para cada destino antes de gerar os arquivos específicos.

Valide uma publicação automatizada

Rejeite uma combinação incompatível antes que o processador crie uma imagem no formato errado.

Crie uma pré-visualização do corte

Sobreponha o retângulo e as margens à origem antes de aprovar o enquadramento.

Perguntas frequentes

A ferramenta envia ou redimensiona minha imagem?

Não. Ela recebe apenas dimensões e nomes de destino e retorna a geometria sem receber, guardar ou alterar pixels.

Quanto custa o cálculo pela API?

O preço da API é US$ 0,002 por solicitação. A versão no navegador executa localmente o mesmo cálculo determinístico.

Por que alguns valores do corte são decimais?

O centro ou a proporção exata podem cair entre pixels. A geometria decimal preserva a moldura matemática até o arredondamento final.

O que acontece com uma plataforma ou posição desconhecida?

A solicitação falha com um erro de entrada. A calculadora nunca tenta adivinhar a proporção de uma combinação incompatível.

O corte mantém o assunto importante no quadro?

Ele centraliza o maior retângulo possível, mas não analisa o conteúdo. Confira o resultado e desloque a moldura se necessário.

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/image/social-preset-resize

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/image/social-preset-resize \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"width":2400,"height":1600,"platform":"instagram","placement":"post"}'

const res = await fetch("https://api.kit.forhosting.com/image/social-preset-resize", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "width": 2400,
    "height": 1600,
    "platform": "instagram",
    "placement": "post"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/social-preset-resize",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "width": 2400,
    "height": 1600,
    "platform": "instagram",
    "placement": "post"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/social-preset-resize", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"width":2400,"height":1600,"platform":"instagram","placement":"post"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"width":2400,"height":1600,"platform":"instagram","placement":"post"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/social-preset-resize", 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

{
  "width": 2400,
  "height": 1600,
  "platform": "instagram",
  "placement": "post"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "image.social_preset_resize",
  "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,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_mb`	15
`max_megapixels`	12

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 →