Перейти к содержимому
POST AI agent ready /v1/og/generate

OG Image API — бесплатный генератор открытых графов

Создавайте фирменные изображения Open Graph для обмена в социальных сетях. Передайте заголовок и необязательное описание, выберите светлую или темную тему, установите цвет акцента и укажите URL-адрес своего логотипа. API возвращает готовый к использованию PNG-файл, который можно использовать в качестве метатега 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

Динамический предварительный просмотр сообщений в блоге

Создавайте уникальное изображение OG для каждого сообщения в блоге во время публикации. Передайте заголовок и отрывок публикации в API, кешируйте полученный PNG-файл в своей CDN, и каждая публикация в социальной сети получит фирменный предварительный просмотр без ручной работы над дизайном.

Карты общего доступа к информационной панели SaaS

Когда пользователи делятся ссылкой на отчет или панель мониторинга, вы можете на лету создать изображение организационной структуры, включающее заголовок отчета и сводную статистику. Получатели видят расширенный предварительный просмотр вместо общего резервного варианта.

Карточки товаров электронной коммерции

Создавайте изображения для предварительного просмотра в социальных сетях для страниц продуктов, передавая название продукта, цену и цвет бренда. Каждая ссылка на продукт, опубликованная в Twitter, Slack или LinkedIn, представляет собой безупречную карточку.

Frequently asked questions

Какие размеры использует сгенерированное изображение OG?
API возвращает PNG 1200x630 — рекомендуемый размер для изображений Open Graph и Twitter Card. Это разрешение хорошо отображается в Facebook, LinkedIn, Twitter, Slack и Discord.
Могу ли я использовать собственный шрифт?
API поставляется с чистым шрифтом без засечек, оптимизированным для удобства чтения при предварительном просмотре в социальных сетях. Загрузка собственных шрифтов в настоящее время не поддерживается.
Как мне использовать это в качестве тега og:image?
Вы можете либо вызвать API во время сборки, сохранить PNG в своей CDN и указать этот URL-адрес в своем метатеге; or point the og:image URL directly at the API endpoint if you prefer on-demand generation.
Ответ кэшируется?
API не кэширует ответы. Если вы отправите одни и те же параметры дважды, каждый раз будет генерироваться новое изображение. Для производственного использования сохраните результат в собственной CDN или объектном хранилище.
Что произойдет, если я опущу описание?
Изображение отображается только с заголовком, центрированным по вертикали. Это хорошо работает для коротких, резких заголовков.

Get your API key

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