功能说明

动态生成占位图片,支持自定义尺寸、背景色与文字颜色。图片中央统一显示其自身尺寸(如 640x480),默认返回 PNG 位图,可直接作为图片资源引用;也支持 SVG 矢量格式(format=svg)。

请求

GET /api/placeholder/{size}

路径参数

参数 类型 说明
size string 尺寸,支持 宽x高(如 300x200)或单独 (如 400,正方形)

查询参数

参数 类型 默认值 说明
bg string cccccc 背景颜色(6 位十六进制,可带或不带 #
fg string 555555 文字颜色(6 位十六进制,可带或不带 #
format string png 输出格式,支持 png(默认)或 svg
size string 当路径未提供 size 时,可通过该参数指定(格式同上)

尺寸上限为 5000x5000,超出将自动截断。

响应

返回 image/png 类型的图片内容,图片中央显示其尺寸,可直接作为图片资源使用:

<img src="/api/placeholder/300x200?bg=eeeeee&fg=333333" />

示例

GET /api/placeholder/300x200
GET /api/placeholder/400
GET /api/placeholder/640x480?bg=1e90ff&fg=ffffff
GET /api/placeholder/800x150?bg=222222&fg=ffcc00
GET /api/placeholder/300x200?size=300x200&bg=c0ffee&format=svg

错误码