使用 API 生成 Twitter 卡片图片
Twitter（X）卡片图片是在 X 上分享链接时显示的大尺寸预览图。FastOG 会以 1200×630 的尺寸动态生成该图片，并通过 summary_large_image 进行标识，因此每个页面都能获得合适的 X 卡片，无需手动创建图片。
Twitter 卡片图片的要求
X 会读取 Open Graph 标签，并在页面链接 twitter:card = summary_large_image 时渲染 summary_large_image 卡片。图片以 1200×630 的尺寸渲染。FastOG 生成的正是这种规格，您可以将 twitter:image 指向与 og:image 相同的动态 URL。
如何配置动态 Twitter 卡片
生成一次 FastOG URL，然后将 OG 和 Twitter 的 meta 标签都设置为该 URL。
html
<meta property="og:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="My Post">
<meta name="twitter:image" content="https://fastog.com/api/v1/og?template=default&title=My+Post&key=sk_...&s=...">
同一个 URL 适用于两个标签。如果缺少
twitter:image，X 会回退到og:image，但同时设置两者是无害且明确的。
X 卡片验证器提示
| 检查项 | 详情 |
|---|---|
| 公开 URL | 图片必须能被 X 在无需认证的情况下获取 |
| 文件大小 / 格式 | 保持在 5 MB 以下；文本卡片最好使用 PNG |
| 缓存 | X 会积极缓存——请使用卡片验证器强制刷新 |
| 签名 URL | FastOG 的内容签名 URL 仅限制首次渲染；缓存的卡片仍然有效 |
常见问题解答
我是否需要为 X 和 Open Graph 分别准备不同的图片？
不需要。X 会读取同一张 1200×630 的图片。本页面之所以存在，是因为正确的 twitter:card 标签很容易出错。
为什么我修改标题后，X 卡片没有更新？
X 会缓存旧卡片。打开 X 卡片验证器，粘贴 URL，然后重新抓取。
FastOG 是否也会处理 twitter 元标签？
FastOG 生成图片；你仍然需要将 twitter:card 和 twitter:image 元标签添加到你的页面中（如上所示）。我们的免费 Open Graph 元标签生成器 会为你生成所有标签。