批量裁剪图片
批量裁剪图片 是有文档说明的 APIAny 免费 API 工具：先在浏览器试用，再用 API 密钥调用同一操作。
从多张图片裁剪相同像素区域，并将有效结果合并为一个 ZIP。
POST /api/free/batch-crop-images来源
本页引用了哪些官方资料？
以下引文来自 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 按相同像素坐标从每张可处理图片中截取矩形区域；由于源图尺寸可能不同，系统会逐张校验。
常见工作流
- 从棚拍图片中提取位置一致的主体区域。
- 裁掉使用相同画布布局导出的截图边缘。
- 为内容发布流水线生成固定裁剪版本。
- 01上传需要通过批量裁剪图片处理的图片。
- 02为整批文件设置一组统一参数。
- 03运行任务，检查逐文件状态，并下载 ZIP 或 JSON 结果。
重复提交 files 字段，然后设置图片文件, 左侧偏移, 顶部偏移, 裁剪宽度, 裁剪高度, 输出格式。每张源图都会独立检查，确保共享裁剪区域没有越界。
通过 API 接入
程序调用批量接口时，必须使用付费账户下的 API Key；一个批量任务按一次 API 请求计数。
POST /api/free/batch-crop-images请使用付费账户的 APIAny Key。每次 API 请求最多 20 个文件、合计 100 MB。
- 每张源图都会独立检查，确保共享裁剪区域没有越界。
- 越界图片记录在 manifest.json 中，有效图片仍可正常下载。
响应结果
请求成功后返回 zip 类型响应，Content-Type 与本页说明一致。
常见错误
- 400
- 缺少文件或参数、值无效，或者超出页面标注的限制。
- 401
- 程序调用缺少 API Key，或 Key 无效、已停用。
- 429
- 在线或鉴权调用已达到共享限速。
参数与限制
| 参数 | 要求 | 默认值 | 可用值 |
|---|---|---|---|
files图片文件 | 必填 | — | file |
left左侧偏移 | 必填 | 0 | number |
top顶部偏移 | 必填 | 0 | number |
width裁剪宽度 | 必填 | 500 | number |
height裁剪高度 | 必填 | 500 | number |
format输出格式 | 选填 | webp | webp, png, jpeg |
API 调用示例
下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。
curl -X POST "https://apiany.ai/api/free/batch-crop-images" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.jpg" \ -F "left=0" \ -F "top=0" \ -F "width=500" \ -F "height=500" \ -F "format=webp" \ --output cropped-images.zip
常见问题
谁可以运行批量裁剪图片？
页面公开可见，但在线执行需要登录付费账户，API 调用需要付费账户的 Key。
批量裁剪图片有哪些文件限制？
在线任务最多 10 个文件、合计 50 MB；API 最多 20 个文件、合计 100 MB；单文件最大 30 MB。
批量裁剪图片返回什么？
接口返回ZIP + manifest.json。越界图片记录在 manifest.json 中，有效图片仍可正常下载。
批量裁剪图片遇到单个文件失败还能完成吗？
可以。文件独立处理，成功结果会保留，失败项会返回明确错误码。