批量提取图片配色
批量提取图片配色 是有文档说明的 APIAny 免费 API 工具：先在浏览器试用，再用 API 密钥调用同一操作。
从多张图片提取代表性 HEX 颜色，并按上传顺序返回 JSON。
POST /api/free/batch-color-palette来源
本页引用了哪些官方资料？
以下引文来自 APIAny 对照实现的官方 API 文档。
The Fetch API provides an interface for fetching resources (including across the network).
The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP and AVIF images of varying dimensions.
The Images API provides several endpoints that let you generate images from text prompts or create edits of existing images.
在线批量提取图片配色
在线上传和管理一批图片时无需填写 API Key；执行任务需要登录付费账户。
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
2. 预览与下载
包含预览、文件大小变化和下载按钮
什么时候适合使用这个批量 API
批量图片配色 API 会对多张图片独立采样，为每个文件返回代表性 HEX 颜色及近似占比；它属于确定性分析，不会生成图片。
常见工作流
- 为商品列表批量生成颜色色板。
- 比较不同营销素材的视觉主题。
- 从内容配图中提取界面强调色候选。
- 01上传需要通过批量提取图片配色处理的图片。
- 02为整批文件设置一组统一参数。
- 03运行任务，检查逐文件状态，并下载 ZIP 或 JSON 结果。
重复提交 files 字段，然后设置图片文件, 颜色数量。每张图片独立采样，并统一使用 3 到 8 之间的指定颜色数量。
通过 API 接入
程序调用批量接口时，必须使用付费账户下的 API Key；一个批量任务按一次 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 值、近似比例与逐文件错误。
批量提取图片配色遇到单个文件失败还能完成吗？
可以。文件独立处理，成功结果会保留，失败项会返回明确错误码。