批量调整图片尺寸
批量调整图片尺寸 是有文档说明的 APIAny 免费 API 工具：先在浏览器试用，再用 API 密钥调用同一操作。
对多张图片应用相同宽高、适配方式与格式，并下载含清单的 ZIP。
POST /api/free/batch-resize-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 将同一尺寸和适配策略应用到多张图片，并单独记录每个输出，适合让一组素材符合统一版式约束。
常见工作流
- 将商品目录图片统一适配电商展示位。
- 从不同尺寸原图生成一致的内容缩略图。
- 在对象存储或 CDN 分发前标准化用户上传图片。
- 01上传需要通过批量调整图片尺寸处理的图片。
- 02为整批文件设置一组统一参数。
- 03运行任务，检查逐文件状态，并下载 ZIP 或 JSON 结果。
重复提交 files 字段，然后设置图片文件, 宽度, 高度, 适配方式, 输出格式, 质量。对所有可处理图片应用相同的缩放参数，同时保留逐文件错误。
通过 API 接入
程序调用批量接口时，必须使用付费账户下的 API Key；一个批量任务按一次 API 请求计数。
POST /api/free/batch-resize-images请使用付费账户的 APIAny Key。每次 API 请求最多 20 个文件、合计 100 MB。
- 对所有可处理图片应用相同的缩放参数，同时保留逐文件错误。
- ZIP 包含处理后的图片，以及记录原始和输出尺寸的 manifest.json。
响应结果
请求成功后返回 zip 类型响应，Content-Type 与本页说明一致。
常见错误
- 400
- 缺少文件或参数、值无效，或者超出页面标注的限制。
- 401
- 程序调用缺少 API Key，或 Key 无效、已停用。
- 429
- 在线或鉴权调用已达到共享限速。
参数与限制
| 参数 | 要求 | 默认值 | 可用值 |
|---|---|---|---|
files图片文件 | 必填 | — | file |
width宽度 | 必填 | 1200 | number |
height高度 | 选填 | — | number |
fit适配方式 | 选填 | inside | cover, contain, fill, inside, outside |
format输出格式 | 选填 | webp | webp, png, jpeg |
quality质量 | 选填 | 82 | number |
API 调用示例
下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。
curl -X POST "https://apiany.ai/api/free/batch-resize-images" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.jpg" \ -F "width=1200" \ -F "fit=inside" \ -F "format=webp" \ --output resized-images.zip
常见问题
谁可以运行批量调整图片尺寸？
页面公开可见，但在线执行需要登录付费账户，API 调用需要付费账户的 Key。
批量调整图片尺寸有哪些文件限制？
在线任务最多 10 个文件、合计 50 MB；API 最多 20 个文件、合计 100 MB；单文件最大 30 MB。
批量调整图片尺寸返回什么？
接口返回ZIP + manifest.json。ZIP 包含处理后的图片，以及记录原始和输出尺寸的 manifest.json。
批量调整图片尺寸遇到单个文件失败还能完成吗？
可以。文件独立处理，成功结果会保留，失败项会返回明确错误码。