占位图 / 徽章 / 文字图片 API

生成 SVG 占位图、shields 风格徽章、文字转图片，可直接写进 <img> 的 src

数据来源：本地计算

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

占位图（SVG）：指定宽高、文字和颜色

GET /api/placeholder

请求参数

  • width：宽度（像素，1~4000），示例 300
  • height：高度（像素，1~4000），示例 200
  • text：显示的文字，最多 60 个字符；不传时显示“宽 × 高”，示例 Banner
  • bg：背景色，3 或 6 位十六进制（可带 #，网址中 # 需写成 %23），示例 dbeafe
  • color：文字颜色，3 或 6 位十六进制，示例 1e40af
  • fontSize：字号（像素，6~400）；不传时按图片尺寸和文字长度自动计算，示例 40

徽章（SVG，shields.io 风格）：“标签 | 内容”，可用于 README

GET /api/badge

请求参数

  • message（必填）：右侧内容，最多 60 个字符，示例 passing
  • label：左侧标签，最多 60 个字符；不传则只显示右侧，示例 build
  • color：右侧底色：十六进制，或 brightgreen / green / yellowgreen / yellow / orange / red / blue / lightgrey / grey / purple / pink / black / success / important / critical / informational / inactive，示例 blue
  • labelColor：左侧底色，取值同 color，示例 555
  • style：flat 圆角带渐变 / flat-square 直角纯色，示例 flat-square

文字转图片（SVG）：自动换行，简约 / 深色 / 纸张三种样式

GET /api/text-image

请求参数

  • text（必填）：文字内容，最多 1000 个字符，可用换行符（%0A）分段，示例 白日依山尽，黄河入海流。 欲穷千里目，更上一层楼。
  • style：simple 白底 / dark 深色 / paper 纸张（衬线字体），示例 paper
  • fontSize：字号（像素，12~120），示例 36
  • width：图片宽度（像素，200~1600），高度按内容自动计算，示例 720
  • align：对齐：left 左对齐 / center 居中，示例 center
  • bg：自定义背景色（十六进制），覆盖样式默认值，示例 fff7ed
  • color：自定义文字颜色（十六进制），覆盖样式默认值，示例 7c2d12