仅限付费账户
批量提取图片配色
从多张图片提取代表性 HEX 颜色，并按上传顺序返回 JSON。
POST /api/free/batch-color-palette在线批量提取图片配色
在线上传和管理一批图片时无需填写 API Key；执行任务需要登录付费账户。
付费权限 · 无 Key 输入框
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
图片文件 *
颜色数量
填写必填参数后即可运行工具。POST /api/free-online/batch-color-palette
2. 预览与下载
结果将在这里显示
包含预览、文件大小变化和下载按钮
什么时候适合使用这个批量 API
批量图片配色 API 会对多张图片独立采样，为每个文件返回代表性 HEX 颜色及近似占比；它属于确定性分析，不会生成图片。
常见工作流
- 为商品列表批量生成颜色色板。
- 比较不同营销素材的视觉主题。
- 从内容配图中提取界面强调色候选。
- 01上传需要通过批量提取图片配色处理的图片。
- 02为整批文件设置一组统一参数。
- 03运行任务，检查逐文件状态，并下载 ZIP 或 JSON 结果。
重复提交 files 字段，然后设置图片文件, 颜色数量。每张图片独立采样，并统一使用 3 到 8 之间的指定颜色数量。
通过 API 接入
程序调用批量接口时，必须使用付费账户下的 API Key；一个批量任务按一次 API 请求计数。
API 接口
POST /api/free/batch-color-palette请使用付费账户的 APIAny Key。每次 API 请求最多 20 个文件、合计 100 MB。
工作原理
- 每张图片独立采样，并统一使用 3 到 8 之间的指定颜色数量。
- 有序 JSON 包含 HEX 值、近似比例与逐文件错误。
响应结果
请求成功后返回 json 类型响应，Content-Type 与本页说明一致。
常见错误
- 400
- 缺少文件或参数、值无效，或者超出页面标注的限制。
- 401
- 程序调用缺少 API Key，或 Key 无效、已停用。
- 429
- 在线或鉴权调用已达到共享限速。
参数与限制
| 参数 | 要求 | 默认值 | 可用值 |
|---|---|---|---|
files图片文件 | 必填 | — | file |
count颜色数量 | 选填 | 5 | 3, 4, 5, 6, 7, 8 |
API 调用示例
下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API 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"
常见问题
谁可以运行批量提取图片配色？
页面公开可见，但在线执行需要登录付费账户，API 调用需要付费账户的 Key。
批量提取图片配色有哪些文件限制？
在线任务最多 10 个文件、合计 50 MB；API 最多 20 个文件、合计 100 MB；单文件最大 30 MB。
批量提取图片配色返回什么？
接口返回JSON。有序 JSON 包含 HEX 值、近似比例与逐文件错误。
批量提取图片配色遇到单个文件失败还能完成吗？
可以。文件独立处理，成功结果会保留，失败项会返回明确错误码。
信息来源：APIAny 免费 API 目录与实际路由行为。内容复核日期：2026-07-17。