Public API

Documentation for MixBlob’s color and palette endpoints.

Use the public API to convert colors, extract palettes, generate gradients, and bring MixBlob’s color workflow into your own products.

Colors: Mix

Interpolate a color ramp between two colors in HSL or RGB space.

Request

curl -X POST https://api.mixipaint.com/v1/colors/mix \
+  -H "content-type: application/json" \
+  -H "x-api-key: YOUR_API_KEY" \
+  -d '{"colors":["#ff0000","#0000ff"],"mode":"hsl","steps":5}'

Body

{
  "colors": [
    "#ff0000",
    "#0000ff"
  ],
  "mode": "hsl",
  "steps": 5
}

Response

{
  "colors": [
    "#ff0000",
    "#bf0040",
    "#800080",
    "#4000bf",
    "#0000ff"
  ]
}

Errors

  • 400 invalid body
  • 401 missing API key

Rate Limits

Basic: 60 req/min (burst 100), 10,000/month. Pro: higher limits.