Reference
API Documentation
placeimg.dev generates SVG placeholder images directly from the URL — no signup, no API key, no JavaScript required. Embed any image by crafting a URL like https://placeimg.dev/400x300/4F46E5 and dropping it into an img tag. Images are cached permanently at the CDN layer.
All dimensions are in pixels. Maximum size is 2000×2000px. Colors are 6-digit hex values without the # prefix.
- Size (rectangle)Width x Height in pixels. Example: /400x300 returns a 400x300 SVG.
- Size (square)Single value for square images. Example: /400 returns a 400x400 SVG.
- Background colorHex color for background. Example: /400x300/FF5733 returns a 400x300 SVG with #FF5733 background.
- Gradient backgroundComma-separated hex colors for a linear gradient. Example: /400?gradient=FF5733,4F46E5
- TextCentered text. Example: /400x300?text=Hello+World
- Text colorHex color for text. Example: /400/222222?text=White+Text&textColor=ffffff
- Combined optionsAll options can be combined in a single URL.
Avatar API
Generative avatar URLs
Generate deterministic SVG avatars from any seed string — username, email, ID, or any arbitrary text. The same seed always produces the same color and initials. Supports initials or silhouette styles. No signup, no API key.
Initials style
Silhouette style
- Basic avatarSeed → initials + background color. Always the same for the same seed.
- Email seedEmail address as seed. Domain is stripped; initials are derived from the local part.
- Full name seedSpace-separated names produce first+last initials. Encode spaces as %20.
- Silhouette stylePerson silhouette instead of initials. Works with any seed.
- Silhouette + squareSquare shape with silhouette style.
- Custom sizeSize in pixels. Default 64. Range 16–512.
- Square shapeReturns a square instead of the default circle.
- CombinedAll params can be combined.
