Generate placeholder images programmatically via REST API

Embed placeholders directly in Markdown, seed CI pipelines with fixture images, and let AI agents populate dynamic content — all over HTTP with no browser required.

Read the API docsLoad automation presetDownload PNG pack

What you can automate

Markdown & HTML embedding

Reference a URL directly in your README or docs and get an inline placeholder image without saving a file.

CI/CD fixture generation

Hit the API in your pipeline step to produce deterministic images for visual regression tests without manual downloads.

AI agent workflows

Let agents call the API to populate UI mockups, seed databases, or generate pack ZIPs as part of an automated task.

Dynamic content

Generate images on the fly in staging environments, preview apps, or content management systems without committing static assets.

Start in three steps

  1. 1

    Pick your size and format

    Construct a URL like /api/v1/800x600.svg or /api/v1/hero:1600x900.png — alias, dimensions, and format all in one path.

  2. 2

    Add optional parameters

    Append ?bg=4F46E5&text=FFFFFF&padding=16 to control colors, padding, stroke, and the text template.

  3. 3

    Fetch or embed

    Use curl, fetch(), wget, or an <img> src — the response is raw image bytes with the correct Content-Type.

Automation & API FAQ

Do I need an API key?
No API key required. The API is public with a rate limit of 30 requests per 60 seconds per IP address.
What formats are supported?
SVG, PNG, and WebP. Append .svg, .png, or .webp to the size spec in the URL path.
Can I generate a ZIP pack via API?
Yes. POST to /api/v1/pack with a JSON body containing sizes, bgColor, textColor, and format. You'll get back a ZIP file.

Related guides