图片转换 API 文档 - WebP 转换 REST API

概述

Convert2WebP API 允许您以编程方式在格式之间转换图像。发送包含图像的多部分请求，并在响应正文中接收转换后的文件。所有处理都在服务器端进行，大多数文件的延迟为亚秒级。

基本网址

https://convert2webp.com/api/v1

身份验证

无需身份验证。 API是免费且开放的。所有请求的速率限制为每个 IP 地址每分钟 60 个请求。

速率限制

速率限制适用于每个 IP 地址。所有响应都包含速率限制标头。

限制	最大文件大小	最大批处理文件数
60 个请求/分钟	每个文件 10 MB	每批 20 个文件

每个响应中都包含速率限制标头： X-RateLimit-Remaining, X-RateLimit-Reset.

接口端点

将单个图像转换为目标格式。接受 multipart/form-data 以及图像文件和可选参数。

参数

姓名	类型	必需的	描述
file	File	必需的	要转换的图像文件。接受 PNG、JPG、GIF、BMP、TIFF、SVG、AVIF、ICO 和 WebP。
output_format	string	选修的	目标输出格式：webp、png、jpg、gif、bmp 或 pdf。(默认: `webp`)
quality	integer	选修的	输出质量从 1（最低）到 100（最高）。(默认: `80`)
width	integer	选修的	最大输出宽度（以像素为单位）。纵横比被保留。
height	integer	选修的	最大输出高度（以像素为单位）。纵横比被保留。
strip_metadata	boolean	选修的	从输出中去除 EXIF/IPTC/XMP 元数据。(默认: `true`)

响应

200

转换后的图像二进制image/webp

400

无效请求（缺少文件、不支持的格式等）application/json

413

文件太大application/json

429

超出速率限制application/json

500

服务器内部错误application/json

代码示例

terminal

curl -X POST https://convert2webp.com/api/v1/convert \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.webp

在线试用

文件

未选择文件

格式

质量 (80)

在单个请求中转换多个图像。返回包含所有已转换文件的 ZIP 存档。

参数

姓名	类型	必需的	描述
files	File[]	必需的	要转换的图像文件数组。每个请求最多 20 个文件。
format	string	选修的	应用于所有文件的目标输出格式。(默认: `webp`)
quality	integer	选修的	输出质量从 1 到 100。(默认: `80`)

响应

200

ZIP 存档包含所有转换后的图像application/zip

400

无效请求application/json

413

总有效载荷太大application/json

429

超出速率限制application/json

代码示例

terminal

curl -X POST https://convert2webp.com/api/v1/batch \
  -F "files=@image1.png" \
  -F "files=@image2.jpg" \
  -F "files=@image3.gif" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.zip

列出所有支持的输入和输出图像格式。

响应

200

JSON 对象列出支持的输入和输出格式application/json

代码示例

terminal

curl https://convert2webp.com/api/v1/formats

响应示例

response.json

{
  "input": [
    "png", "jpg", "jpeg", "gif", "bmp",
    "tiff", "svg", "avif", "ico", "webp"
  ],
  "output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}

检查服务可用性。

响应

200

服务状态及版本application/json

代码示例

terminal

curl https://convert2webp.com/api/v1/health

响应示例

response.json

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-04T12:00:00.000Z"
}

错误码

所有错误响应都会返回一个 JSON 主体，其中包含 error 描述出了什么问题的对象。

error-response.json

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}

代码	姓名	描述
400	错误的请求	请求格式错误。检查所有必需的参数是否存在且有效。
413	有效负载太大	上传的文件超过 10 MB 限制。
415	不支持的媒体类型	上传的文件格式不支持转换。
429	请求过多	您已超出速率限制（每分钟 60 个请求）。等待并重试。
500	内部服务器错误	发生意外错误。如果这种情况仍然存在，请联系 convert2webp@deployvision.com。