仅限付费账户
批量裁剪图片
从多张图片裁剪相同像素区域，并将有效结果合并为一个 ZIP。
POST /api/free/batch-crop-images在线批量裁剪图片
在线上传和管理一批图片时无需填写 API Key；执行任务需要登录付费账户。
付费权限 · 无 Key 输入框
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
图片文件 *
左侧偏移 *
顶部偏移 *
裁剪宽度 *
裁剪高度 *
输出格式
填写必填参数后即可运行工具。POST /api/free-online/batch-crop-images
2. 预览与下载
结果将在这里显示
包含预览、文件大小变化和下载按钮
什么时候适合使用这个批量 API
批量图片裁剪 API 按相同像素坐标从每张可处理图片中截取矩形区域；由于源图尺寸可能不同，系统会逐张校验。
常见工作流
- 从棚拍图片中提取位置一致的主体区域。
- 裁掉使用相同画布布局导出的截图边缘。
- 为内容发布流水线生成固定裁剪版本。
- 01上传需要通过批量裁剪图片处理的图片。
- 02为整批文件设置一组统一参数。
- 03运行任务，检查逐文件状态，并下载 ZIP 或 JSON 结果。
重复提交 files 字段，然后设置图片文件, 左侧偏移, 顶部偏移, 裁剪宽度, 裁剪高度, 输出格式。每张源图都会独立检查，确保共享裁剪区域没有越界。
通过 API 接入
程序调用批量接口时，必须使用付费账户下的 API Key；一个批量任务按一次 API 请求计数。
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 中，有效图片仍可正常下载。
批量裁剪图片遇到单个文件失败还能完成吗？
可以。文件独立处理，成功结果会保留，失败项会返回明确错误码。
信息来源：APIAny 免费 API 目录与实际路由行为。内容复核日期：2026-07-17。