---
title: "Analyse Image"
method: POST
path: "/analyse/image"
---

# Analyse Image

`POST /analyse/image`

## Request

- Base URL: `https://api.colourmemory.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.colourmemory.com/analyse/image`
- Auth: none declared

Extract dominant colours from an image using k-means clustering.
Deterministic — same image always returns same palette.
Feed hex values directly into POST /brand/audit.

Returns colours ranked by pixel area percentage.

## Headers

- `x-api-key` string, nullable
- `origin` string, nullable

## Request body

- AnalyseImageRequest
  - `image_base64` string, required
  - `k` integer
  - `exclude_neutrals` boolean
  - `min_area_pct` number

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/colourmemory/apis/colour-memory-api.md) · [All operations](https://skmtc.dev/colourmemory/apis/colour-memory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/colourmemory/apis/colour-memory-api/revisions/4ba028f64042?raw)