批量转换图片格式
批量转换图片格式 是有文档说明的 APIAny 免费 API 工具：先在浏览器试用，再用 API 密钥调用同一操作。
将多张图片统一转换为 WebP、PNG、JPEG 或 AVIF，并下载含逐文件清单的 ZIP。
POST /api/free/batch-convert-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 在一个可控任务中，把多张来源图片统一转换为指定 Web 格式，适合确定性的素材标准化，不属于生成式图片编辑。
常见工作流
- 商品发布前将混合格式统一转换为 WebP。
- 为客户批量生成一致的 JPEG 或 PNG 交付文件。
- 把重复的图片格式转换接入后端自动化流程。
- 01上传需要通过批量转换图片格式处理的图片。
- 02为整批文件设置一组统一参数。
- 03运行任务，检查逐文件状态，并下载 ZIP 或 JSON 结果。
重复提交 files 字段，然后设置图片文件, 输出格式, 质量。付费账户每次 API 请求最多转换 20 张图片，在线 Playground 最多 10 张。
通过 API 接入
程序调用批量接口时，必须使用付费账户下的 API Key；一个批量任务按一次 API 请求计数。
POST /api/free/batch-convert-images请使用付费账户的 APIAny Key。每次 API 请求最多 20 个文件、合计 100 MB。
- 付费账户每次 API 请求最多转换 20 张图片，在线 Playground 最多 10 张。
- 成功文件与 manifest.json 一起返回；单个图片失败不会中止整批任务。
响应结果
请求成功后返回 zip 类型响应，Content-Type 与本页说明一致。
常见错误
- 400
- 缺少文件或参数、值无效，或者超出页面标注的限制。
- 401
- 程序调用缺少 API Key，或 Key 无效、已停用。
- 429
- 在线或鉴权调用已达到共享限速。
参数与限制
| 参数 | 要求 | 默认值 | 可用值 |
|---|---|---|---|
files图片文件 | 必填 | — | file |
format输出格式 | 选填 | webp | webp, png, jpeg, avif |
quality质量 | 选填 | 82 | number |
API 调用示例
下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。
curl -X POST "https://apiany.ai/api/free/batch-convert-images" \ -H "Authorization: Bearer $API_KEY" \ -F "files=@a.png" \ -F "files=@b.jpg" \ -F "format=webp" \ -F "quality=82" \ --output converted-images.zip
常见问题
谁可以运行批量转换图片格式？
页面公开可见，但在线执行需要登录付费账户，API 调用需要付费账户的 Key。
批量转换图片格式有哪些文件限制？
在线任务最多 10 个文件、合计 50 MB；API 最多 20 个文件、合计 100 MB；单文件最大 30 MB。
批量转换图片格式返回什么？
接口返回ZIP + manifest.json。成功文件与 manifest.json 一起返回；单个图片失败不会中止整批任务。
批量转换图片格式遇到单个文件失败还能完成吗？
可以。文件独立处理，成功结果会保留，失败项会返回明确错误码。