extract_image_colours
ActiveTool of Colour Memory
declared in 2.3.4
Extract dominant colours from a photograph using Colour Memory's proprietary k-means++ algorithm. Requires either a public image_url, or an image_id. If you only have a raw uploaded file with no public URL (e.g. a local file path or a ChatGPT file attachment without a usable download_url), call ingest_image first to get an image_id, then pass that image_id here. Returns hex values with proportional weights. Optionally matches colours against the archive with style_context for coherent cultural naming. Use this before image_brief when you have an uploaded photograph.
Parameters schema
{
"type": "object",
"required": [],
"properties": {
"k": {
"type": "integer",
"description": "Number of colours to extract (3-12, default 6)"
},
"image": {
"type": "object",
"required": [],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"description": "Image file attachment from ChatGPT"
},
"analyse": {
"type": "boolean",
"description": "If true, match colours against archive and return names"
},
"image_id": {
"type": "string",
"description": "Ephemeral image_id returned by ingest_image. Use this if you only have a local file path or raw file attachment with no public URL."
},
"image_url": {
"type": "string",
"description": "Public URL of image"
},
"grey_card_hex": {
"type": "string",
"description": "Hex from a grey/white card for white balance"
},
"style_context": {
"type": "string",
"description": "e.g. English cottage garden, Victorian, Japanese"
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Colour Memory
https://github.com/DigbyO/colour-memory-api
2/7 registries