Color Palette & Design Toolkit
## Overview The Color Palette & Design Toolkit API provides 21 endpoints for color conversion, palette generation, accessibility checking, and color analysis. Built for designers, developers, and accessibility teams. ## Key Features - **Color Conversion**: HEX ↔ RGB ↔ HSL ↔ HSV ↔ CMYK with full precision - **Palette Generation**: Complementary, analogous, triadic, tetradic, split-complementary,…
Color Palette & Design Toolkit endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
Generate a harmonious color palette /palette/generate |
Generate a color palette from a base color using classical color theory harmony modes: complementary, analogous, triadic, tetradic, split-complementary, or monochromatic. |
| GET |
Generate a random aesthetically pleasing palette /palette/random |
Uses the golden-ratio hue distribution to generate a visually balanced random palette. Every call returns a unique result. |
| GET |
Full color identification /extract/identify |
Get complete information about a hex color: all format representations, CSS name match, luminance, and whether it's considered dark or light. |
| GET |
Extract a cohesive palette from a list of hex colors /palette/from-image-colors |
Given a list of hex colors (e.g. from an image's dominant colors), this endpoint sorts, deduplicates, and returns a cohesive palette along with the dominant color. |
| GET |
Convert a color to all formats /convert |
Convert a single hex color to RGB, HSL, HSV, CMYK, CSS name, luminance, and more. Accepts 3- or 6-digit hex with or without the `#` prefix. |
| GET |
Batch convert multiple colors /convert/batch |
Convert up to 50 hex colors in a single request. |
| GET |
Get the CSS/X11 name for a hex color /convert/name |
Returns the nearest CSS named color for any hex input. If the color is an exact CSS named color, `distance` will be 0 and `exact_match` true. |
| GET |
Calculate WCAG contrast ratio /accessibility/contrast |
Compute the WCAG 2.1 contrast ratio between two colors. Returns the ratio and pass/fail status for all WCAG levels. |
| GET |
Full WCAG AA/AAA compliance check /accessibility/check |
Check whether a foreground/background color pair meets WCAG AA and AAA standards for normal text, large text, and UI components. Returns a human-readable recommendation. |
| GET |
Simulate color blindness /accessibility/simulate |
Simulate how a color appears to people with protanopia, deuteranopia, or tritanopia. Pass `types` to limit which simulations to run (default: all three). |
| GET |
Suggest accessible color pairs /accessibility/suggest |
Given a brand/background color, suggest foreground colors that meet the target WCAG contrast ratio. Default target is 4.5 (AA for normal text). Results are sorted by contrast… |
| GET |
Extract dominant colors from a hex palette /extract/dominant |
Given a list of hex colors (e.g. from an image or brand palette), identify the dominant color using luminance-weighted scoring. Returns the dominant color plus a ranked list. |
| GET |
Find nearest CSS named color /extract/nearest-css |
Given any hex color, find the nearest CSS/X11 named color using Euclidean RGB distance. Returns the name, its hex value, the distance, and whether it was an exact match. |
| GET |
List all CSS named colors /extract/css-colors |
Returns the complete database of all 148 CSS named colors with their hex values. |
| GET |
Mix two colors /blend/mix |
Blend two hex colors together. `ratio=0` returns color1, `ratio=1` returns color2, `ratio=0.5` returns an even mix. Uses linear RGB interpolation. |
| GET |
Generate a color gradient /blend/gradient |
Generate an N-step linear gradient between two colors. Returns each step's hex, RGB, and its 0.0–1.0 position, plus a ready-to-use CSS `linear-gradient()` string. |
| GET |
Generate tints of a color /blend/tints |
Generate lighter versions of a color by progressively mixing it with white. step=1 is the lightest tint closest to white, step=N is closest to the original. |
| GET |
Generate tones of a color /blend/tones |
Generate desaturated (grayed) versions of a color by progressively reducing saturation. step=1 is the most desaturated (gray), step=N is closest to the original saturation. |
| GET |
Generate shades of a color /blend/shades |
Generate darker versions of a color by progressively mixing it with black. step=1 is the darkest shade, step=N is closest to the original. |
| GET |
API information / |
|
| GET |
Health check /health |
Color Palette & Design Toolkit pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| Pro | $9.99 / month | 20 / minute |
|
| Ultra | $29.99 / month | 100 / minute |
|