Skip to content
POST AI agent ready /v1/placeholder

Placeholder Image API - Free Custom Sizes

Create placeholder images for wireframes, prototypes, and development. Specify exact dimensions, overlay text, pick background and foreground colors, and choose SVG or PNG output. Useful during front-end development when final assets are not available.

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

Wireframe prototyping

Drop placeholder images into Figma exports or HTML prototypes so stakeholders can review layout and spacing before photography or illustration is ready.

CMS content staging

Populate a staging CMS with correctly sized placeholders for each image field. Content editors see the exact space each photo will occupy before uploading final assets.

Automated test fixtures

Generate predictable placeholder images in integration tests for image upload flows. Assert dimensions and file type without relying on static fixture files.

Frequently asked questions

What is the maximum image size?
You can request images up to 4000x4000 pixels. For larger sizes, consider generating an SVG and rasterizing it on your own server to avoid large payloads.
Can I use custom fonts for the text overlay?
The API renders text in a default sans-serif font. Custom font support is not available. If you need a specific typeface, fetch the SVG and update the font-family attribute in the markup.
What text appears if I leave the text parameter empty?
The image displays its dimensions, for example "600x400". This makes it easy to verify sizing at a glance during development.
Should I choose SVG or PNG?
SVG is smaller in file size and scales to any resolution without blur. PNG is better when you need a raster file for upload to systems that do not accept SVG, such as some email clients.
Can I set a transparent background?
Transparency is not supported. Specify a bg color that matches your page background for a similar effect.

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