> For the complete documentation index, see [llms.txt](/llms.txt).
[miniwebtool /api](/)
[tools](/tools/) [docs](/docs/) [reference](/v1/docs) [pricing](/#pricing) [log in](/dashboard/login/) [get free key →](/billing/checkout/?plan=free)
- [~](/)
- /
- [tools](/tools/)
- /
- [color](/tools/#color)
- /
- Color Scheme Generator API

# Color Scheme Generator API

color 1 credit / call v2026-04-22
Generate complementary, analogous, triadic, square, tetradic, and monochromatic palettes.
One POST adds Color Scheme Generator to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled.
prefer a UI? [Open the Color Scheme Generator on miniwebtool.com →](https://miniwebtool.com/color-scheme-generator/)
[Start free — get a key →](/billing/checkout/?plan=free) 1,000 credits · no card · 30 seconds

### Endpoint

POST · 1cr

```text
POST https://api.miniwebtool.com/v1/tools/color-scheme-generator/run
```

### Request body

Field
Type
Req.
`base_color`
`str`
—
`scheme`
all | complementary | analogous | triadic | split_complementary | square | tetradic | monochromatic
`str`
—
`precision`
`int`
—

### Cost & access

- 1 credit per successful call — failed calls refund.
- Starts on: Free.
- Max payload:`65536`bytes.
- Privacy mode:`hash_only`
- Available on: free, starter, pro, business, scale

### Response envelope

```text
{
  "request_id": "01K...",
  "tool": "color-scheme-generator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {... }
}
```

### Try it

API key *
Stored only in this browser tab. Playground test key is prefilled and only works on this page. [Get a live key →](/billing/checkout/?plan=free)
base_color (str) #6366f1
scheme (str) all complementary analogous triadic split_complementary square tetradic monochromatic
all | complementary | analogous | triadic | split_complementary | square | tetradic | monochromatic
precision (int)
Send request →
Response copy body
This endpoint starts on Free
Your key is valid, but its current plan cannot call`color-scheme-generator`. Upgrade to Free or higher to run this tool.
[Start Free →](/billing/checkout/?plan=free) [Compare plans](/#pricing)

```text

```

Response headers

```text

```

### Code examples

cURL Python JavaScript PHP Ruby Go Java
copy

```text
curl -X POST https://api.miniwebtool.com/v1/tools/color-scheme-generator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"base_color":"#6366f1","scheme":"all","precision":1}'
```

copy

```text
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/color-scheme-generator/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={'base_color': '#6366f1', 'scheme': 'all', 'precision': 1},
)
resp.raise_for_status()
print(resp.json())
```

copy

```text
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/color-scheme-generator/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({"base_color":"#6366f1","scheme":"all","precision":1}),
  }
);
const data = await resp.json();
console.log(data);
```

copy

```text
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/color-scheme-generator/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'base_color' => '#6366f1',
    'scheme' => 'all',
    'precision' => 1
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
```

copy

```text
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/color-scheme-generator/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {
  'base_color' => '#6366f1',
  'scheme' => 'all',
  'precision' => 1
}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
```

copy

```text
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _:= json.Marshal(map[string]interface{}{
    "base_color": "#6366f1",
    "scheme": "all",
    "precision": 1,
  })
  req, _:= http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/color-scheme-generator/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err:= http.DefaultClient.Do(req)
  if err!= nil { panic(err) }
  defer resp.Body.Close()
  out, _:= io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
```

copy

```text
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
.uri(URI.create("https://api.miniwebtool.com/v1/tools/color-scheme-generator/run"))
.header("Authorization", "Bearer mwt_live_YOUR_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\"base_color\":\"#6366f1\",\"scheme\":\"all\",\"precision\":1}"))
.build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
```

how-to call color-scheme-generator
- Get an API key
[Get an API key](/billing/checkout/?plan=free). Sign up free for a bearer token. 1,000 credits/month, no card.
- Assemble the JSON body
Required fields:. See the Request body table above for the full schema.
- POST to`https://api.miniwebtool.com/v1/tools/color-scheme-generator/run`
Headers:`Authorization: Bearer <key>`and`Content-Type: application/json`. Copy-paste snippets in 7 languages are under Code examples.
- Parse the response
Envelope:`{request_id, tool, tool_version, credits_used, result}`. The typed output lives in`result`.
faq frequently asked
What does the Color Scheme Generator API do? +
Generate complementary, analogous, triadic, square, tetradic, and monochromatic palettes. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.
How much does one call to Color Scheme Generator cost? +
1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.
What parameters does the Color Scheme Generator API require? +
Required fields: (none). Full schema at /v1/openapi.json.
Is the Color Scheme Generator API deterministic? +
Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.
Can an AI agent call the Color Scheme Generator API? +
Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `color-scheme-generator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.
What format does the API return? +
JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.
mcp use from an AI agent
Every endpoint on this site is also exposed via the [Model Context Protocol](/docs/#mcp) at`https://api.miniwebtool.com/v1/mcp`. Claude, Cursor, and any MCP-capable agent can discover this tool (`color-scheme-generator`) and its JSON Schema automatically — no client codegen.

```text
# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="color-scheme-generator")'
```

see-also related color tools
[
Color Code Converter
Convert HEX, RGB, HSL, HSV, CMYK, and common CSS named colors.
](/tools/color-code-converter-all-formats/) [
Color Contrast Checker
Check WCAG contrast ratio and AA/AAA compliance for two colors.
](/tools/color-contrast-checker/)
API OPERATIONAL v1 · OpenAPI 3.1 · MCP 2025-06-18
[terms](https://miniwebtool.com/about/terms-and-disclaimer/#api-terms) [privacy](https://miniwebtool.com/about/privacy/#api-privacy) [llms.txt](/llms.txt) [consumer site →](https://miniwebtool.com) © 2026 miniwebtool
