Image dominant colors

POST /api/image-dominant-colors

Extract the dominant colours of an image. Returns hex / RGB / HSL plus pixel-coverage percentage. Useful for theme generation, design palettes, and image categorisation.

Returns the most prominent colours in an image — typically used for design palettes, theme generation from photos, and image categorisation by mood. Inputs: - `count` (default 5): how many colours to return. - `format`: `hex` (default), `rgb`, or `hsl`. Each returned colour includes its pixel-coverage percentage, so you can weight them when building a palette.

Inputs

Name	Type	Default	Description
image*	file	—	Input image (PNG / JPEG / WebP).
n	number (1…64)	5	Number of dominant colours to return.

Response

Modes: json. Cache: yes (24h TTL).