Dynamic OG Image

RapidAPI2026-06-20 更新2026-06-21 收录

社交分享卡生成

动态图像渲染

数据链接：

https://rapidapi.com/lejunterkevin/api/dynamic-og-image 数据链接链接失效反馈

官方服务：

资源简介：

Turn one URL into a branded 1200×630 social share card. Drop it in og:image and every page gets a unique preview — rendered at the edge, cached forever.

创建时间：

2026-06-20

原始信息汇总

数据集概述：Dynamic OG Image API

数据集名称：Dynamic OG Image API

数据集描述：该API可通过单个GET请求生成品牌化的Open Graph / 社交分享图片（1200x630 PNG格式）。生成的图片可直接嵌入到网页的 og:image 元标签中，使每个页面、博客文章、产品或个人资料在X/Twitter、LinkedIn、Slack、Discord、Facebook、iMessage和WhatsApp等平台上拥有独特的预览卡片。

主要功能与亮点：

边缘渲染：使用Satori渲染，并嵌入Inter字体，确保文字清晰、排版真实。
模板与主题：提供两种模板（简约、渐变），支持浅色/深色主题，可自定义品牌强调色（十六进制），并支持使用表情符号或远程Logo作为卡片标记。
自动适应标题：长标题会自动缩小并换行，确保完整显示在图片框内。
不可变缓存：每个参数组合渲染一次后，在CDN上以1年最大年龄进行不可变缓存，并带有确定的ETag。重复请求可通过If-None-Match返回304状态码，不消耗计算资源。

适用场景：

博客和CMS的OG卡片
动态的用户或产品分享图片
更新日志和文档预览
营销落地页
链接简介工具（link-in-bio）
无代码平台（如Webflow、Framer、Bubble）

关键词：OG image, open graph image, social card, social share image, dynamic og:image, twitter card, link preview image, meta image generator, banner generator

认证方式：所有请求通过RapidAPI网关发送，需要提供RapidAPI密钥：

X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: og-image-api-theta.vercel.app

端点（Endpoints）：

GET /api/health
- 存活检查端点。返回HTTP 200及{"ok":true}。
- 无需代理保护，适用于监控工具。
GET /api/og
- 生成社交卡片（image/png）。
- 必需查询参数：
  - title（必填）：主标题，最多200字符，自动缩小和换行。
- 可选查询参数：
  - subtitle：副标题，最多300字符。
  - theme：light或dark（默认dark）。
  - template：minimal或gradient（默认minimal）。
  - accent：品牌强调色十六进制值（需URL编码#为%23）。
  - emoji：用作卡片标记的表情符号，最多8字符（需URL编码）。
  - logo：用作标记的绝对HTTPS图片URL（覆盖emoji，有SSRF防护）。
- 示例请求： bash curl "https://og-image-api-theta.vercel.app/api/og?title=Hello+World&subtitle=Test" -o card.png
- 响应格式：1200x630 PNG图片。
- 响应头：
  - content-type: image/png
  - cache-control: public, max-age=31536000, immutable
  - etag: W/"31ab41e153d3e35"
- 错误码：
  - 400：missing_title / invalid_accent / invalid_template
  - 429：rate_limited（每IP每分钟60次请求）
  - 500：render_failed