Ir al contenido
POST AI agent ready /v1/og/generate

API de imágenes OG: generador de gráficos abierto gratuito

Cree imágenes de marca Open Graph para compartir en redes sociales. Pase un título y una descripción opcional, elija un tema claro u oscuro, establezca un color de acento e incluya la URL de su logotipo. La API devuelve un PNG listo para usar que puede servir como metaetiqueta og:image.

Parameters

stringrequired

Primary text rendered on the image. Keep it under 60 characters for best results.

string

Secondary text rendered below the title. Optional but recommended for context.

string

Background theme for the generated image.

string

Accent color as a hex code (include the #). Applied to highlights and borders.

string

URL to a logo image displayed on the card. PNG or SVG recommended.

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

Vistas previas dinámicas de publicaciones de blog

Genere una imagen OG única para cada publicación de blog en el momento de la publicación. Pase el título de la publicación y el extracto a la API, almacene en caché el PNG resultante en su CDN y cada recurso compartido en redes sociales obtendrá una vista previa de la marca sin trabajo de diseño manual.

Tarjetas para compartir del panel SaaS

Cuando los usuarios comparten un informe o un enlace al panel, genere una imagen OG sobre la marcha que incluya el título del informe y una estadística resumida. Los destinatarios ven una vista previa enriquecida en lugar de un respaldo genérico.

Tarjetas de productos de comercio electrónico

Cree imágenes de vista previa social para páginas de productos pasando el nombre del producto, el precio y el color de la marca. Cada enlace de producto compartido en Twitter, Slack o LinkedIn genera una tarjeta pulida.

Frequently asked questions

¿Qué dimensiones utiliza la imagen OG generada?
La API devuelve un PNG de 1200x630, el tamaño recomendado para imágenes de Open Graph y Twitter Card. Esta resolución se muestra bien en Facebook, LinkedIn, Twitter, Slack y Discord.
¿Puedo usar una fuente personalizada?
La API se envía con una fuente sans-serif limpia y optimizada para facilitar la lectura en tamaños de vista previa de redes sociales. En este momento no se admiten cargas de fuentes personalizadas.
¿Cómo sirvo esto como mi etiqueta og:image?
Puede llamar a la API en el momento de la compilación, guardar el PNG en su CDN y hacer referencia a esa URL en su metaetiqueta; o apunte la URL og:image directamente al punto final de la API si prefiere la generación bajo demanda.
¿La respuesta está almacenada en caché?
La API no almacena en caché las respuestas. Si envía los mismos parámetros dos veces, genera una imagen nueva cada vez. Para uso en producción, almacene el resultado en su propia CDN o almacenamiento de objetos.
¿Qué pasa si omito la descripción?
La imagen se representa solo con el título, centrado verticalmente. Esto funciona bien para titulares breves y contundentes.

Get your API key

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

Sign up free View full docs