Skip to content

快速开始

服务地址

生产环境使用自定义域名:

https://og.159499.xyz

(绑定自定义域名后,*.workers.dev 子域默认关闭,统一用上面的域名。)

第一个请求

生成一张默认 base 模板的图(默认 SVG 格式):

bash
curl -L "https://og.159499.xyz/og?title=Hello%20OG&subtitle=我的第一张图" -o demo.svg

直接用浏览器打开该 URL 也能看到图像——响应体就是图片字节。

指定模板与格式

bash
# 路径形式指定模板(优先于 query 的 template 参数)
curl -L "https://og.159499.xyz/og/blank-1?heading=通知&body=正文内容&font=宋体" -o note.svg

# 输出 PNG
curl -L "https://og.159499.xyz/og/base?title=Hi&format=png" -o card.png

<img> / <meta> 中直接使用

因为响应就是图片,前端可直接把 URL 放进 src

html
<img src="https://og.159499.xyz/og/base?title=标题&subtitle=副标题" alt="OG" />

<!-- Open Graph 社交分享卡片 -->
<meta property="og:image" content="https://og.159499.xyz/og/base?title=标题&subtitle=副标题" />

下一步

基于 VitePress 构建 · 接口随代码演进,以线上 /templates 为准