Seeded color palette API

Generates a reproducible N-color palette in a chosen harmony scheme (analogous/complementary/triadic/random) from a seed, returning hex + HSL for each. The value-add: stable themed palettes anchored on a seed-derived base hue, with correct HSL-to-hex conversion. Answers 'Generate a deterministic color palette from this seed', 'Give me a reproducible analogous color scheme.'.

Price$0.01per request

MethodPOST

Route/v1/generate/color-palette

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

colorpaletteharmonyhslhexdeterministicseeddesign

API URLhttps://x402.hexl.dev/v1/generate/color-palette

Integration docs

Example request

{
  "seed": "abc",
  "count": 3,
  "scheme": "analogous"
}

Example response

{
  "colors": [
    {
      "hex": "#1ea2ae",
      "hsl": "hsl(185, 71%, 40%)",
      "hue": 185
    },
    {
      "hex": "#6b9ee6",
      "hsl": "hsl(215, 71%, 66%)",
      "hue": 215
    },
    {
      "hex": "#6155e2",
      "hsl": "hsl(245, 71%, 61%)",
      "hue": 245
    }
  ],
  "count": 3,
  "scheme": "analogous",
  "baseHue": 185,
  "saturation": 71,
  "seed": "abc",
  "deterministic": true,
  "interpretation": "Reproducible analogous 3-color palette anchored on hue 185."
}

Input schema

{
  "type": "object",
  "required": [
    "seed"
  ],
  "properties": {
    "seed": {
      "type": [
        "string",
        "number"
      ],
      "examples": [
        "abc"
      ]
    },
    "count": {
      "type": "integer",
      "minimum": 2,
      "maximum": 16,
      "examples": [
        3
      ]
    },
    "scheme": {
      "type": "string",
      "enum": [
        "analogous",
        "complementary",
        "triadic",
        "random"
      ],
      "examples": [
        "analogous"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}