ForHosting KIT · Imagens

Link sem imagem no WhatsApp?

Gere a imagem OG — o cartão que aparece quando alguém cola o seu link no WhatsApp, no LinkedIn ou no X — de forma automática. Você manda o título, a descrição e o estilo, e a API devolve a imagem no tamanho padrão de 1200 × 630, uma para cada página do site.

● Estávelpor imagemUS$ 0,040

Executar — US$ 0,040 + US$ 0,001/imagem 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.

No Brasil, link circula pelo WhatsApp

Antes de qualquer clique, o link vira um cartão na conversa: imagem, título, descrição. Se a imagem não existe, sobra um retângulo apagado que ninguém toca — e no WhatsApp, onde o brasileiro compartilha de notícia a promoção, essa primeira impressão decide o clique. A imagem OG é a vitrine do link. Ter uma boa para cada página, e não a mesma genérica no site inteiro, é o que separa um compartilhamento atraente de um ignorado.

Uma imagem por página, sem designer de plantão

Fazer arte manual para cada post, produto ou vaga não escala. Aqui a imagem nasce de um modelo: você define o estilo uma vez — cores, disposição, marca — e a chamada envia os textos daquela página específica. O blog publica, o cartão existe; o produto entra no catálogo, o cartão existe. O designer desenha o modelo uma única vez e a API fabrica as milhares de variações, todas coerentes entre si.

Como a imagem é montada

A tarefa renderiza um layout real — como uma página — e o fotografa no tamanho exato de 1200 × 630, o padrão que WhatsApp, LinkedIn, X e demais redes leem bem. Isso permite tipografia caprichada, acentos corretos e composição flexível, em vez de texto carimbado sobre um fundo fixo. O resultado volta pronto para ser referenciado na tag og:image da página; a execução é assíncrona, com task_id e resposta em segundos.

O que custa automatizar isso

US$ 0,040 por chamada mais US$ 0,001 por imagem gerada. Um blog que publica 30 posts por mês gasta pouco mais de US$ 1 mensal para nunca mais ter link pelado; um catálogo que gera 5.000 cartões paga o preço publicado, sem plano nem franquia. A conta se faz antes de integrar — os valores estão nesta página.

Casos de uso

Blog com cartão bonito em todo post

O blog da TecnoSul gera a imagem OG na publicação: título do post sobre o fundo da marca, sempre no padrão. Quando o texto roda nos grupos de WhatsApp, o cartão chega apresentável — sem ninguém abrir editor.

Produto compartilhado com foto e preço

Na loja da Distribuidora Horizonte Verde, cada produto tem um cartão OG com nome e chamada gerados sob demanda. O cliente que manda o link para a esposa decide a compra ali mesmo, na prévia da conversa.

Vaga de emprego que se espalha sozinha

O RH publica vagas que os funcionários compartilham no LinkedIn. Cada vaga ganha um cartão com cargo e cidade — “Analista fiscal – Belo Horizonte” — e a divulgação orgânica rende muito mais que o link cru.

Perguntas frequentes

Por que o WhatsApp não mostra imagem quando colam meu link?

Quase sempre porque a página não aponta uma imagem na tag og:image, ou aponta uma em tamanho inadequado. Gerar o cartão e referenciá-lo na tag resolve o caso típico.

O tamanho 1200 × 630 serve para todas as redes?

É o padrão mais bem aceito: WhatsApp, LinkedIn, X e Facebook o exibem bem. Ter esse formato correto já cobre a imensa maioria dos compartilhamentos.

Quanto custa gerar os cartões do meu site?

US$ 0,040 por chamada mais US$ 0,001 por imagem. Cem páginas geradas numa chamada em lote custam cerca de US$ 0,14 — pagamento por uso, sem mensalidade.

Consigo usar minha identidade visual no cartão?

Sim: o modelo é seu — cores, fontes, logotipo e disposição. A API só troca os textos e monta a imagem final de cada página.

Título com acento e cedilha sai correto?

Sai: a renderização usa tipografia real, então “Promoção”, “São João” e afins aparecem como devem, sem caracteres quebrados.

Os textos que envio são usados para outra coisa?

Não — servem para montar a sua imagem e devolver o arquivo. A tarefa termina aí.

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/og

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/og \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/imagen.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/image/og", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/imagen.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/image/og",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/imagen.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/image/og", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/imagen.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/imagen.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/image/og", 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

{
  "image": "https://ejemplo.com/imagen.jpg"
}

Exemplo de resposta

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

por imagemUS$ 0,001

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.
`422`	`task_failed`	A tarefa falhou do nosso lado. Você não paga nada por ela.

Ver a documentação completa do KIT →