圖片轉換 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。