跳转到内容
POST AI agent ready /v1/og/generate

OG Image API - 免费开放图生成器

创建品牌开放图谱图像以进行社交共享。 传递标题和可选描述,选择浅色或深色主题,设置强调色,并包含您的徽标 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 仪表板共享卡

当用户共享报告或仪表板链接时,即时生成包含报告标题和摘要统计数据的 OG 图像。 收件人看到的是丰富的预览,而不是通用的后备。

电商产品卡

通过传递产品名称、价格和品牌颜色为产品页面创建社交预览图像。 在 Twitter、Slack 或 LinkedIn 上共享的每个产品链接都会呈现一张精美的卡片。

Frequently asked questions

生成的 OG 图像使用什么尺寸?
API 返回 1200x630 PNG,这是 Open Graph 和 Twitter 卡图像的建议大小。 此分辨率在 Facebook、LinkedIn、Twitter、Slack 和 Discord 上显示良好。
我可以使用自定义字体吗?
该 API 附带了一种干净的无衬线字体,该字体针对社交媒体预览尺寸的可读性进行了优化。 目前不支持自定义字体上传。
我如何将其作为我的 og:image 标签?
您可以在构建时调用 API,将 PNG 保存到 CDN,然后在元标记中引用该 URL; 或者,如果您更喜欢按需生成,请将 og:image URL 直接指向 API 端点。
响应是否被缓存?
API 不缓存响应。 如果您发送相同的参数两次,它每次都会生成一个新的图像。 对于生产用途,请将结果存储在您自己的 CDN 或对象存储上。
如果我省略描述会怎样?
图像仅与标题一起渲染,垂直居中。 这对于简短而有力的标题非常有效。

Get your API key

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