scheme: Generate color scheme

API: thecolorapi.com:the-color-api
Endpoint: /scheme
Response format: text/plain
Auth: unknown
Method: GET
Last Status: 200
Latency: 419ms

Description

Returns a generated color scheme based on a seed color and specified mode (monochrome, complement, triad, etc.)

Parameters (10)

callback (string, query, optional)

JSONP callback function name

cmyk (string, query, optional)

Valid CMYK color (e.g., 100,58,0,33)

count (integer, query, optional, default: 5)

Number of colors to return

format (string, query, optional, default: json)

Return format

Constraints: {'enum': ['json', 'html', 'svg']}

hex (string, query, optional)

Valid hex code without # (e.g., 0047AB)

Constraints: {'pattern': '^[0-9A-Fa-f]{6}$'}

hsl (string, query, optional)

Valid HSL color (e.g., 215,100%,34% or hsl(215,100%,34%))

mode (string, query, optional, default: analogic)

Scheme generation mode

Constraints: {'enum': ['monochrome', 'monochrome-dark', 'monochrome-light', 'analogic', 'complement', 'analogic-complement', 'triad', 'quad']}

named (boolean, query, optional, default: True)

Whether to print color names on image (SVG only)

rgb (string, query, optional)

Valid RGB color (e.g., 0,71,171 or rgb(0,71,171))

w (integer, query, optional, default: 100)

Width of resulting image (SVG format only)

Examples (2)

Generate color scheme openapi-spec
curl 'https://www.thecolorapi.com/scheme?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33'
import requests

resp = requests.get(
    "https://www.thecolorapi.com/scheme",
    params={
        'hex': '0047AB',
        'rgb': '0,71,171',
        'hsl': '215,100%,34%',
        'cmyk': '100,58,0,33',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("thecolorapi")
result = api.fetch("scheme", hex="0047AB", rgb="0,71,171", hsl="215,100%,34%", cmyk="100,58,0,33")

for item in result:
    print(item)
const resp = await fetch("https://www.thecolorapi.com/scheme?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33");
const data = await resp.json();
Generate color scheme probe-gate
curl 'https://www.thecolorapi.com/scheme?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33&mode=analogic&count=5&format=json&w=100&named=True'
import requests

resp = requests.get(
    "https://www.thecolorapi.com/scheme",
    params={
        'hex': '0047AB',
        'rgb': '0,71,171',
        'hsl': '215,100%,34%',
        'cmyk': '100,58,0,33',
        'mode': 'analogic',
        'count': '5',
        'format': 'json',
        'w': '100',
        'named': 'True',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("thecolorapi")
result = api.fetch("scheme", hex="0047AB", rgb="0,71,171", hsl="215,100%,34%", cmyk="100,58,0,33", mode="analogic", count=5, format="json", w=100, named="True")

for item in result:
    print(item)
const resp = await fetch("https://www.thecolorapi.com/scheme?hex=0047AB&rgb=0%2C71%2C171&hsl=215%2C100%25%2C34%25&cmyk=100%2C58%2C0%2C33&mode=analogic&count=5&format=json&w=100&named=True");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 17:45:42.329245 200 419ms
2026-04-16 03:26:59.526907 200 427ms
2026-04-16 01:11:45.464070 200 473ms
2026-04-15 03:42:09.042245 200 487ms
2026-04-15 01:37:10.801287 200 435ms
2026-04-14 02:51:36.117659 200 443ms
2026-04-14 00:57:24.304149 200 459ms
2026-04-12 16:16:28.922784 200 446ms
2026-04-12 12:40:59.774366 200 441ms
2026-04-10 06:47:18.849662 200 378ms
2026-04-10 01:35:51.606296 200 359ms
2026-04-09 00:41:51.493670 200 457ms
2026-04-09 00:01:39.931057 200 624ms
2026-03-28T07:35:53.516134 200 377ms