Batch Extract Color Palettes
Extract representative HEX colors from multiple images in one ordered JSON response.
POST /api/free/batch-color-paletteUse Batch Extract Color Palettes online
Upload and manage a batch without entering an API key. Running the job requires a signed-in paid account.
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
When to use this batch API
A batch color palette API samples multiple images and returns representative HEX colors with approximate proportions for each file. It performs deterministic analysis rather than image generation.
Common workflows
- Create color swatches for product listings.
- Compare visual themes across campaign assets.
- Seed interface accents from a collection of editorial images.
- 01Upload the images you want to process with Batch Extract Color Palettes.
- 02Choose one shared parameter set for the whole batch.
- 03Run the job, review per-file status, and download the ZIP or JSON result.
Use repeated files fields, then set Image files, Color count. Each image is sampled independently with the same requested color count from 3 through 8.
Related single-image API
Use the single-image endpoint for free one-off processing, or this paid batch endpoint for repeatable multi-file work.
Extract Color PaletteIntegrate with the API
Programmatic batch calls require an API key owned by a paid account. One batch request counts as one API request.
POST /api/free/batch-color-paletteUse an APIAny key from a paid account. The API accepts up to 20 files and 100 MB total per request.
- Each image is sampled independently with the same requested color count from 3 through 8.
- The ordered JSON result includes HEX values, approximate ratios and isolated per-file errors.
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 |
|---|---|---|---|
filesImage files | 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/batch-color-palette" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.jpg" \ -F "count=5"
Frequently asked questions
Who can run Batch Extract Color Palettes?
The page is public, but online execution requires a paid login and API calls require a paid account key.
What are the Batch Extract Color Palettes file limits?
Online jobs accept 10 files and 50 MB total; API jobs accept 20 files and 100 MB total; each file can be 30 MB.
What does Batch Extract Color Palettes return?
It returns JSON. The ordered JSON result includes HEX values, approximate ratios and isolated per-file errors.
Can Batch Extract Color Palettes finish when one file fails?
Yes. Files are processed independently, successful results remain available, and failed items include an error code.