提取图片配色

提取图片中的代表性 HEX 颜色及大致占比。

POST /api/free/color-palette

在线提取图片配色

上传、设置、预览与下载都不需要 API Key。

无需登录或 API Key

1. 上传与设置

无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。

图片文件 *

点击选择文件，或拖拽到这里JPG · PNG · WebP · AVIF · 30 MB只有运行工具时才会上传文件。

颜色数量

填写必填参数后即可运行工具。POST /api/free-online/color-palette

2. 预览与下载

结果将在这里显示

包含预览、文件大小变化和下载按钮

付费批量版本

需要对多个文件重复执行同一操作时，可进入对应的付费批量页面。

批量提取图片配色

通过 API 接入

仅程序调用需要 API Key；参数、响应和错误信息集中展示。

API 接口

POST /api/free/color-palette

在线使用免 Key；程序调用此接口时需要 APIAny Key。

工作原理

分析前会缩小采样图片，以控制 CPU 消耗。
颜色按照估算出现频率从高到低返回。

响应结果

请求成功后返回 json 类型响应，Content-Type 与本页说明一致。

常见错误

400: 缺少文件或参数、值无效，或者超出页面标注的限制。
401: 程序调用缺少 API Key，或 Key 无效、已停用。
429: 在线或鉴权调用已达到共享限速。

参数与限制

参数	要求	默认值	可用值
`image`图片文件	必填	—	file
`count`颜色数量	选填	5	3, 4, 5, 6, 7, 8

API 调用示例

下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。

curl -X POST "https://apiany.ai/api/free/color-palette" \
  -H "Authorization: Bearer $API_KEY" \
  -F "image=@input.png" \
  -F "count=5"

常见问题

使用提取图片配色需要 API Key 吗？

在线 Playground 无需 Key；程序请求请通过 Authorization: Bearer 或 X-API-Key 发送 APIAny Key。