Generate placeholder image URLs at
spotzee.com/tools/placeholder-image-generator.
Why this matters
Designers and engineers need image-shaped fixtures every day: avatars in user lists, hero images in layout tests, thumbnails in card grids, SVG placeholders in storybook screens. Hard-coding URLs against public CDNs from inside test data scatters dependencies and breaks when those services change. A placeholder image endpoint keeps URL formats in one well-tested place. Pass a numeric seed for reproducible avatars and Picsum URLs across runs. Reach for SVG data URIs when fixtures must work offline, in print, or inside locked-down preview environments. Each Extended API call deducts a small per-call amount from your Spotzee credit balance. The endpoint returns URLs and data URIs only; image bytes are served by the public CDNs the URLs reference. See the Spotzee pricing page for live per-tool pricing.How it works
1
Send the request
POST to
/generic/data/generate/image with count. The count is a string
from 1 to 100.2
Choose a method
Pick
profile for the bundled record, or one of url, urlPicsumPhotos,
urlLoremFlickr, avatar, avatarGitHub, personPortrait or dataUri.3
Set scoped options
Width and height work for URL and data-URI methods. Category targets
urlLoremFlickr. Greyscale and blur target urlPicsumPhotos. Colour and
SVG type target dataUri. Sex and size target personPortrait.4
Read the response
The response returns
data.images[], generated, locale, optional
seed and the resolved method. Profile records also fill the per-method
URL fields.Method reference
Pick
profile to inspect every output shape at once. Pick a method when fixtures need one URL shape per record.
What to watch for
- Count outside
1to100. One request returns up to 100 records. Call the endpoint again for larger datasets. - Width or height outside
1to3999. Both must be positive integers up to 3999. They only apply toprofile,url,urlPicsumPhotos,urlLoremFlickranddataUrimethods. - Method-scoped option mismatch. The endpoint rejects unsupported combinations, for example
categorywithurlPicsumPhotos. Useprofileif you want every option active in one record. - Treating fixtures as licensed assets. Returned URLs point at public placeholder services. Confirm each provider’s terms before reusing the assets in production marketing or paid products.
- Unseeded snapshots. Send a numeric
seedwhen tests assert exact URLs or snapshot the rendered output.
FAQs
What is a placeholder image generator?
What is a placeholder image generator?
A placeholder image generator returns synthetic image URLs and SVG data
URIs for tests, examples and design fixtures. Spotzee returns Picsum,
LoremFlickr, GitHub avatar and portrait URLs from one endpoint with
optional size, category, blur and colour controls.
Does this return actual image bytes?
Does this return actual image bytes?
No. Each response value is a URL pointing at a public image service or a
data:image/svg+xml URI you can embed directly. The endpoint never
fetches or proxies image bytes.Can I get a dummy image url at a specific size?
Can I get a dummy image url at a specific size?
Yes. Send
width and height from 1 to 3999 for the url,
urlPicsumPhotos, urlLoremFlickr, dataUri and profile methods.
Avatar and portrait methods use sizes set by the upstream provider.Is this a picsum alternative?
Is this a picsum alternative?
It bundles
urlPicsumPhotos plus LoremFlickr, GitHub avatars, Faker
portraits and SVG data URIs into one endpoint. Use it as a picsum
alternative when fixtures need more than one URL shape.Can I generate offline-friendly placeholder bytes?
Can I generate offline-friendly placeholder bytes?
Yes. Pick
dataUri to return a data:image/svg+xml URI. The SVG
embeds inline, so fixtures keep rendering without network access.Where can I learn more about placeholder image generation?
Where can I learn more about placeholder image generation?
Read the placeholder image generator
guide
for endpoint options, response fields and embedding patterns. The guide
also shows where placeholder image URLs fit beside colour, lorem ipsum,
string and developer fixture generators.