Extract Color Palette
Extract representative HEX colors and approximate proportions from an image.
POST /api/free/color-paletteUse Extract Color Palette online
Upload, configure, preview and download without an API key.
1. Upload and settings
Use this tool online without an API key. Files are sent only when you run the request.
2. Preview and download
Preview, size changes and download controls are shown here
Paid batch option
When the same operation must run across several files, open the matching paid batch page.
Integrate with the API
Only programmatic calls require an API key. Parameters, responses and errors are documented below.
POST /api/free/color-paletteOnline use is keyless. Programmatic calls to this endpoint require an APIAny key.
- The image is downsampled before analysis to control CPU usage.
- Colors are returned in descending order by approximate frequency.
Response
A successful request returns a json response with the Content-Type described by this page.
Common errors
- 400
- A file or parameter is missing, invalid or outside the documented limit.
- 401
- The API key is missing, invalid or disabled for programmatic API calls.
- 429
- The online or authenticated shared rate limit has been reached.
Parameters and limits
| Parameter | Requirement | Default | Accepted values |
|---|---|---|---|
imageImage file | Required | — | file |
countColor count | Optional | 5 | 3, 4, 5, 6, 7, 8 |
API example
Use this authenticated example in code. The online Playground above intentionally does not request or expose your key.
curl -X POST "https://apiany.ai/api/free/color-palette" \ -H "Authorization: Bearer $API_KEY" \ -F "image=@input.png" \ -F "count=5"
Frequently asked questions
Do I need an API key for Extract Color Palette?
No key is required in the online Playground. Programmatic requests use Authorization: Bearer or X-API-Key.
What are the limits for Extract Color Palette?
Online use is limited to 3 requests per minute and 30 per day. Authenticated free accounts receive 5 RPM and paid accounts receive 500 RPM across free APIs.
Which inputs does Extract Color Palette accept?
Use the required and optional fields in the parameter table. Unsupported formats and out-of-range values are rejected.
What does Extract Color Palette return?
Successful requests return a json response. Errors use the HTTP status codes listed above.