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.

Gradients: Suggest

Get gradient suggestions from a seed color and mood.

Request

curl -X POST https://api.mixipaint.com/v1/gradients/suggest \
+  -H "content-type: application/json" \
+  -H "x-api-key: YOUR_API_KEY" \
+  -d '{"seed":"#ff6b6b","mood":"calm","count":4}'

Body

{
  "seed": "#ff6b6b",
  "mood": "calm",
  "count": 4
}

Response

{
  "items": [
    {
      "css": "linear-gradient(135deg, #ff6b6b 0%, #ff9d9d 100%)",
      "colors": [
        "#ff6b6b",
        "#ff9d9d"
      ]
    }
  ]
}

Errors

400 invalid body
401 missing API key

Rate Limits

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