跳转到内容
POST AI agent ready /v1/placeholder

占位符图像 API - 免费自定义尺寸

为线框、原型和开发创建占位符图像。 指定精确尺寸、覆盖文本、选择背景和前景色，然后选择 SVG 或 PNG 输出。 当最终资源不可用时，在前端开发过程中很有用。

Parameters

numberrequired

Image width in pixels.

numberrequired

Image height in pixels.

string

Text overlay centered on the image. Defaults to the dimensions (e.g. "600x400").

string

Background color as a hex code.

string

Text color as a hex code.

Code examples

curl -X POST https://api.botoi.com/v1/placeholder \
  -H "Content-Type: application/json" \
  -d '{"width":600,"height":400,"text":"Hero Banner","bg_color":"#f1f5f9","text_color":"#0f172a"}'

When to use this API

线框原型设计

将占位符图像放入 Figma 导出或 HTML 原型中，以便利益相关者可以在摄影或插图准备好之前检查布局和间距。

CMS 内容分级

为每个图像字段使用正确大小的占位符填充暂存 CMS。 内容编辑者在上传最终资源之前会看到每张照片将占用的确切空间。

自动化测试治具

在图像上传流的集成测试中生成可预测的占位符图像。 断言尺寸和文件类型，而不依赖静态夹具文件。

Frequently asked questions

最大图像尺寸是多少？
您可以请求最大 4000x4000 像素的图像。 对于较大尺寸，请考虑生成 SVG 并在您自己的服务器上对其进行光栅化，以避免较大的有效负载。
我可以为文本叠加使用自定义字体吗？
API 以默认的无衬线字体呈现文本。 不支持自定义字体。 如果您需要特定字体，请获取 SVG 并更新标记中的 font-family 属性。
如果我将文本参数留空，会出现什么文本？
图像显示其尺寸，例如“600x400”。 这使得在开发过程中一目了然地验证尺寸变得很容易。
我应该选择 SVG 还是 PNG？
SVG 文件大小较小，可以缩放到任何分辨率而不会模糊。 当您需要将光栅文件上传到不接受 SVG 的系统（例如某些电子邮件客户端）时，PNG 会更好。
可以设置透明背景吗？
不支持透明度。 指定与页面背景相匹配的背景颜色以获得类似的效果。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs