# Tanod imagepeek – Image Colour Analysis

> Tanod imagepeek – Image Colour Analysis is a paid API for AI agents from tanod.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-11).

Extracts a colour palette, dominant colour, and average colour from any image supplied by URL or base64.

## Facts

- Endpoint: POST https://tanod.dev/v1/image/colors?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-imagepeek-image-colour-analysis-f6415444
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yQJKtFKnvbSTmIuU3hBgq

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-imagepeek-image-colour-analysis-f6415444 -d '<json body>'
```

Example prompt: Can you pull out the top 6 dominant colours from this product image — here's the URL: https://example.com/product.jpg — and give me their hex codes and the overall average colour?

## When to prefer this

Choose this endpoint when you need fast, lightweight colour analysis (palette, dominant, and average colour) from an image provided by URL or base64, without requiring a full computer-vision or ML pipeline. Ideal for design tooling, brand identity workflows, e-commerce colour tagging, and UI theming where only colour metadata is needed rather than object detection or segmentation.

## Known failure modes

- Image URL unreachable or returns non-image content — HTTP error or invalid content-type
- Image exceeds 10 MB — payload too large error
- Neither url nor image_base64 provided — validation error
- Malformed base64 string — decoding error
- Unsupported image format — processing error
- k value outside 1–10 range — validation error

## How this service works

One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.

## Output

Returns a colour palette of k dominant colours, the single dominant colour, and the overall average colour of the image — each expressed as RGB and/or hex values. Palette size k is configurable from 1–10 (default 5).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "k": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Palette size (1-10, default 5)."
  },
  "url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Public http(s) URL of the image (at most 10 MB; private, internal and IP-literal hosts are refused); or use image_base64."
  },
  "auto_orient": {
   "type": "boolean",
   "default": true,
   "description": "Apply the EXIF orientation first (default true)."
  },
  "image_base64": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 13333464
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "The image as standard or url-safe base64 (at most 10 MB decoded; a data:image/...;base64, prefix is fine); or use url."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "input": {
   "bytes": 2183,
   "width": 256,
   "format": "png",
   "frames": 1,
   "height": 256,
   "animated": false,
   "has_alpha": true
  },
  "notes": [],
  "source": {
   "url": "https://python-pillow.org",
   "library": "Pillow",
   "license": "MIT-CMU (HPND)"
  },
  "average": {
   "hex": "#ad8a17",
   "rgb": [
    173,
    138,
    23
   ],
   "luminance": 137.1
  },
  "palette": [
   {
    "hex": "#f3c11a",
    "rgb": [
     243,
     193,
     26
    ],
    "share": 0.6719
   },
   {
    "hex": "#18160f",
    "rgb": [
     24,
     22,
     15
    ],
    "share": 0.3049
   },
   {
    "hex": "#715b13",
    "rgb": [
     113,
     91,
     19
    ],
    "share": 0.0233
   }
  ],
  "dominant": {
   "hex": "#f3c11a",
   "rgb": [
    243,
    193,
    26
   ],
   "share": 0.6719
  },
  "final_url": "https://tanod.dev/icon.png",
  "operation": "colors",
  "source_url": "https://tanod.dev/icon.png",
  "pixels_sampled": 39468
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-imagepeek-image-colour-analysis-f6415444/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tanod.dev](https://www.zero.xyz/host/tanod.dev/llms.txt)