/info0.5 credits per call · 24-hour shared cacheInfo.
BlurHash, palette, and metadata in one round-trip. Four variants share the same 24-hour cache.
# Full payload — metadata, palette, BlurHash, colors
curl 'https://demo.imgapis.com/info?src=unsplash/photo-1506905925346-21bda4d32df4'
GET /infoFull payload — blurhash, palette, metadata. One round-trip, one cache key.
{
"metadata": {
"bytes": 124518,
"contentType": "image/jpeg",
"format": "jpg",
"width": 1600,
"height": 1067
},
"blurhash": "U2TI:j]9fQ|cfQfQt7fQfQfQfQfQfQfQfQfQ",
"colors": [
{ "area": 0.41, "hex": "#1f2937", "intensity": 0.7 },
{ "area": 0.22, "hex": "#9ca3af", "intensity": 0.4 }
],
"palette": {
"vibrant": { "hex": "#ef4444" },
"lightVibrant": { "hex": "#fca5a5" },
"darkVibrant": { "hex": "#7f1d1d" },
"muted": { "hex": "#6b7280" },
"lightMuted": { "hex": "#d1d5db" },
"darkMuted": { "hex": "#374151" }
}
}{
"metadata": {
"bytes": 124518,
"contentType": "image/jpeg",
"format": "jpg",
"width": 1600,
"height": 1067
},
"colors": [
{ "area": 0.41, "hex": "#1f2937", "intensity": 0.7 },
{ "area": 0.22, "hex": "#9ca3af", "intensity": 0.4 }
]
}srcRequired—DefaultSource image — full URL, source-alias form (<source-name>/<path>), or use the path-sugar form /<endpoint>/<source-name>/<path>.
selectOptional—DefaultComma-separated subset of top-level fields to return. Omit for full payload.
blurhashcolorsmetadatapaletteGET /info/blurhashGenerate a stable hash for skeleton placeholders and lazy LCP. Same cache as /info — once warmed, free.
{
"blurhash": "U2TI:j]9fQ|cfQfQt7fQfQfQfQfQfQfQfQfQ"
}srcRequired—DefaultURL-encoded source image URL.
GET /info/colorsExtract a brand palette from any image — auto-theme your UI on upload.
{
"colors": [
{ "area": 0.41, "hex": "#1f2937", "intensity": 0.7 },
{ "area": 0.22, "hex": "#9ca3af", "intensity": 0.4 },
{ "area": 0.18, "hex": "#fef3c7", "intensity": 0.6 }
],
"palette": {
"vibrant": { "hex": "#ef4444" },
"lightVibrant": { "hex": "#fca5a5" },
"darkVibrant": { "hex": "#7f1d1d" },
"muted": { "hex": "#6b7280" },
"lightMuted": { "hex": "#d1d5db" },
"darkMuted": { "hex": "#374151" }
}
}srcRequired—DefaultURL-encoded source image URL.
GET /info/metadataRead width / height / format / bytes without downloading the full bitmap.
{
"metadata": {
"bytes": 124518,
"contentType": "image/jpeg",
"format": "jpg",
"width": 1600,
"height": 1067
}
}srcRequired—DefaultURL-encoded source image URL.
See an image before you transform it.
Index assets on upload
Hit /info once on ingest; cache the BlurHash + palette + dimensions in your DB. Reads are free forever — the API only bills on cache miss.
Auto-theme UI from artwork
Use palette.vibrant and palette.muted as accent colors per album page. Real colors ranked by area share — no JS color extractor in the client bundle.
Pick AVIF vs WebP per asset
/info/metadata tells you format and bytes before you commit a transform URL. Skip the AVIF pass for already-tiny GIFs, force JPEG for emails.
Skeletons that match the image
/info/blurhash returns the 28-char hash you pass straight to your client-side BlurHash decoder. Skeleton matches the image, not a grey box.