ForHosting KIT · Imagens

Imagem para redes sociais

Serviço de API que recebe uma imagem e devolve o conjunto de tamanhos prontos para cada rede social: feed quadrado, formato vertical de story, capa e miniatura. Serve para quem publica a mesma arte em vários canais e não quer recortar versão por versão no editor.

● Estávelpor conjuntoUS$ 0,002

Executar — US$ 0,002 + US$ 0,005/conjunto 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.

Uma arte, cinco recortes, zero retrabalho

Cada rede social exige uma proporção diferente: o que fica perfeito no feed aparece cortado no story e esticado na capa. Quem cuida de vários perfis conhece a rotina de abrir o editor, duplicar a arte, ajustar o enquadramento e exportar de novo — para cada publicação. Esta capacidade elimina essa etapa: você envia a imagem original uma única vez e recebe o conjunto completo de variações, cada uma já na medida certa do canal onde vai ser publicada.

Como funciona na prática

A chamada é simples: você envia a imagem e indica quais formatos precisa. O processamento é assíncrono — a API devolve um task_id e, em seguida, você busca o resultado com as variações prontas para baixar. O recorte preserva a área central da arte, então vale deixar o elemento principal longe das bordas. Dá para integrar o fluxo no seu sistema de agendamento de posts e gerar os conjuntos de toda a semana em uma tacada só.

Formatos e limites

A ferramenta aceita os formatos comuns de imagem, com arquivo de até 15 MB e resolução de até 12 megapixels — mais do que suficiente para artes de divulgação. Uma dica prática: envie sempre a versão de maior resolução que você tiver. Reduzir uma imagem grande mantém a nitidez; ampliar uma imagem pequena, não. Se a arte tem texto, confira depois se ele ficou legível nas variações menores, como a miniatura.

Quanto custa manter todos os canais alimentados

O preço é publicado e por uso: US$ 0,002 por chamada mais US$ 0,005 por conjunto gerado. Sem plano, sem mensalidade, sem surpresa no fim do mês. Fazendo a conta de um caso real: uma agência que produz 200 artes por mês gasta US$ 1,40 para ter todas elas em todos os formatos. É menos do que o tempo que um estagiário levaria para recortar as três primeiras.

Casos de uso

A padaria que posta todo dia

A Padaria Pão Dourado fotografa a fornada da manhã e publica no feed, no story e no status. Com uma chamada, a foto vira as três versões — e quem cuida disso é o próprio dono, do celular, antes de abrir a loja.

Agência com doze clientes

Uma agência de Recife produz artes para doze perfis diferentes. O sistema interno envia cada arte aprovada para a API e arquiva o conjunto de variações na pasta do cliente. O designer desenha uma vez; o resto é automático.

Lançamento de produto em quatro canais

A Distribuidora Horizonte Verde lança um produto novo e precisa da mesma arte na capa da página, no anúncio quadrado e nos stories dos representantes. O marketing gera o conjunto inteiro e distribui os arquivos por e-mail no mesmo dia.

Perguntas frequentes

Quais tamanhos vêm no conjunto?

O conjunto cobre os formatos que as redes sociais usam hoje: quadrado de feed, vertical de story, horizontal de capa e miniatura. Na chamada, você indica quais desses formatos quer receber — não precisa gerar o que não vai usar.

Se eu mandar 50 artes, quanto pago?

Cada arte gera um conjunto: 50 chamadas custam US$ 0,10 e os 50 conjuntos custam US$ 0,25, totalizando US$ 0,35. O preço é sempre por uso, publicado na página — nada de plano mínimo.

A imagem perde qualidade no recorte?

Não, desde que o arquivo original tenha resolução suficiente. As variações são geradas a partir da imagem que você enviou, reduzindo quando necessário — o que preserva a nitidez. O limite de entrada é 15 MB e 12 megapixels.

O que acontece com as artes depois do processamento?

Elas são usadas apenas para gerar as variações que você pediu e não são publicadas nem compartilhadas com terceiros. Se a sua empresa precisa de detalhes para a adequação à LGPD, escreva para a gente que respondemos por escrito.

Não sei programar. Consigo usar mesmo assim?

Esta capacidade funciona via API, então o caminho natural é integrá-la ao seu sistema ou site. Se você não programa, chame a gente no WhatsApp: uma pessoa de verdade responde — em espanhol ou inglês, mas pode escrever em português que a gente se entende.

E quando as redes mudarem os tamanhos recomendados?

Como os formatos são definidos na chamada, basta ajustar as medidas no seu fluxo e gerar os conjuntos novos. Você não fica preso a presets desatualizados.

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-variants

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

const res = await fetch("https://api.kit.forhosting.com/image/social-variants", {
  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/image/social-variants",
    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/image/social-variants", 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/image/social-variants", 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": "image.social_variants",
  "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

por conjuntoUS$ 0,005

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 →