POST AI agent ready /v1/og/generate

API de imagem OG - gerador de gráfico aberto gratuito

Crie imagens de marca Open Graph para compartilhamento social. Passe um título e uma descrição opcional, escolha um tema claro ou escuro, defina uma cor de destaque e inclua o URL do seu logotipo. A API retorna um PNG pronto para uso que pode servir como sua meta tag og:image.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/og/generate \
  -H "Content-Type: application/json" \
  -d '{"title":"Ship faster with the Botoi API","description":"150+ developer endpoints, zero infrastructure to manage.","theme":"dark","color":"#3b82f6","logo":"https://botoi.com/logo.png"}'

When to use this API

Visualizações dinâmicas de postagens de blog

Gere uma imagem OG exclusiva para cada postagem do blog no momento da publicação. Passe o título e o trecho da postagem para a API, armazene em cache o PNG resultante em seu CDN e cada compartilhamento social terá uma visualização da marca sem trabalho manual de design.

Cartões de compartilhamento do painel SaaS

Quando os usuários compartilham um link de relatório ou painel, gere uma imagem OG instantaneamente que inclua o título do relatório e uma estatística resumida. Os destinatários veem uma visualização avançada em vez de um substituto genérico.

Cartões de produtos de comércio eletrônico

Crie imagens de visualização social para páginas de produtos, passando o nome do produto, o preço e a cor da marca. Cada link de produto compartilhado no Twitter, Slack ou LinkedIn gera um cartão sofisticado.

Frequently asked questions

Quais dimensões a imagem OG gerada usa?

A API retorna um PNG de 1200x630, o tamanho recomendado para imagens Open Graph e Twitter Card. Esta resolução é bem exibida no Facebook, LinkedIn, Twitter, Slack e Discord.

Posso usar uma fonte personalizada?

A API vem com uma fonte sem serifa limpa e otimizada para facilitar a leitura em tamanhos de visualização de mídia social. Uploads de fontes personalizadas não são suportados no momento.

Como faço para servir isso como minha tag og:image?

Você pode chamar a API no momento da compilação, salvar o PNG em seu CDN e referenciar esse URL em sua metatag; ou aponte o URL og:image diretamente para o endpoint da API se preferir a geração sob demanda.

A resposta está armazenada em cache?

A API não armazena respostas em cache. Se você enviar os mesmos parâmetros duas vezes, uma nova imagem será gerada a cada vez. Para uso em produção, armazene o resultado em seu próprio CDN ou armazenamento de objetos.

O que acontece se eu omitir a descrição?

A imagem é renderizada apenas com o título, centralizado verticalmente. Isso funciona bem para títulos curtos e contundentes.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.