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.

Palettes: From Image

Generate a color palette and recommended foreground/background from an image.

Request

curl -X POST https://api.mixipaint.com/v1/palettes/from-image \
+  -H "content-type: application/json" \
+  -H "x-api-key: YOUR_API_KEY" \
+  -d '{"imageUrl":"https://example.com/photo.jpg","count":5}'

Body

{
  "imageUrl": "https://example.com/photo.jpg",
  "count": 5
}

Response

{
  "palette": [
    "#aabbcc",
    "#112233",
    "#445566",
    "#778899",
    "#ddeeff"
  ],
  "background": "#ffffff",
  "foreground": "#111111"
}

Errors

400 invalid body or decoding failure
401 missing API key

Rate Limits

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