API
Chuyển đổi hình ảnh qua HTTP
Tổng quan
Convert2WebP API cho phép bạn chuyển đổi hình ảnh giữa các định dạng theo chương trình. Gửi yêu cầu nhiều phần kèm theo hình ảnh của bạn và nhận tệp đã chuyển đổi trong nội dung phản hồi. Tất cả quá trình xử lý diễn ra phía máy chủ với độ trễ dưới giây đối với hầu hết các tệp.
URL cơ sở
https://convert2webp.com/api/v1Xác thực
Không cần xác thực. API là miễn phí và mở. Tất cả các yêu cầu được giới hạn tốc độ ở 60 yêu cầu mỗi phút cho mỗi địa chỉ IP.
Giới hạn tốc độ
Giới hạn tốc độ được áp dụng cho mỗi địa chỉ IP. Tất cả các phản hồi đều bao gồm tiêu đề giới hạn tốc độ.
| Giới hạn | Kích thước tệp tối đa | Tệp hàng loạt tối đa |
|---|---|---|
| 60 yêu cầu/phút | 10 MB mỗi tệp | 20 tập tin mỗi đợt |
Tiêu đề giới hạn tỷ lệ được bao gồm trong mọi phản hồi: X-RateLimit-Remaining, X-RateLimit-Reset.
Điểm cuối
Chuyển đổi một hình ảnh sang định dạng đích. Chấp nhận multipart/form-data với tệp hình ảnh và các tham số tùy chọn.
Tham số
| Tên | Kiểu | Yêu cầu | Sự miêu tả |
|---|---|---|---|
| file | File | Yêu cầu | Tệp hình ảnh cần chuyển đổi. Chấp nhận PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO và WebP. |
| output_format | string | Không bắt buộc | Định dạng đầu ra mục tiêu: webp, png, jpg, gif, bmp hoặc pdf.(mặc định: webp) |
| quality | integer | Không bắt buộc | Chất lượng đầu ra từ 1 (thấp nhất) đến 100 (cao nhất).(mặc định: 80) |
| width | integer | Không bắt buộc | Chiều rộng đầu ra tối đa tính bằng pixel. Tỷ lệ khung hình được giữ nguyên. |
| height | integer | Không bắt buộc | Chiều cao đầu ra tối đa tính bằng pixel. Tỷ lệ khung hình được giữ nguyên. |
| strip_metadata | boolean | Không bắt buộc | Loại bỏ siêu dữ liệu EXIF/IPTC/XMP khỏi đầu ra.(mặc định: true) |
Phản hồi
Ví dụ mã
curl -X POST https://convert2webp.com/api/v1/convert \
-F "file=@photo.png" \
-F "format=webp" \
-F "quality=80" \
-o converted.webpThử ngay
Chuyển đổi nhiều hình ảnh trong một yêu cầu. Trả về kho lưu trữ ZIP với tất cả các tệp được chuyển đổi.
Tham số
| Tên | Kiểu | Yêu cầu | Sự miêu tả |
|---|---|---|---|
| files | File[] | Yêu cầu | Mảng tập tin hình ảnh để chuyển đổi. Tối đa 20 tệp cho mỗi yêu cầu. |
| format | string | Không bắt buộc | Định dạng đầu ra mục tiêu được áp dụng cho tất cả các tệp.(mặc định: webp) |
| quality | integer | Không bắt buộc | Chất lượng đầu ra từ 1 đến 100.(mặc định: 80) |
Phản hồi
Ví dụ mã
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.zipLiệt kê tất cả các định dạng hình ảnh đầu vào và đầu ra được hỗ trợ.
Phản hồi
Ví dụ mã
curl https://convert2webp.com/api/v1/formatsPhản hồi mẫu
{
"input": [
"png", "jpg", "jpeg", "gif", "bmp",
"tiff", "svg", "avif", "ico", "webp"
],
"output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}Kiểm tra tính khả dụng của dịch vụ.
Phản hồi
Ví dụ mã
curl https://convert2webp.com/api/v1/healthPhản hồi mẫu
{
"status": "ok",
"version": "1.0.0",
"timestamp": "2026-04-04T12:00:00.000Z"
}Mã lỗi
Tất cả các phản hồi lỗi đều trả về phần thân JSON với error đối tượng mô tả những gì đã xảy ra.
{
"error": {
"code": 429,
"message": "Rate limit exceeded. Please wait 30 seconds before retrying."
}
}| Mã số | Tên | Sự miêu tả |
|---|---|---|
| 400 | Yêu cầu xấu | Yêu cầu không đúng định dạng. Kiểm tra xem tất cả các tham số bắt buộc có mặt và hợp lệ hay không. |
| 413 | Tải trọng quá lớn | Tệp đã tải lên vượt quá giới hạn 10 MB. |
| 415 | Loại phương tiện không được hỗ trợ | Định dạng tệp đã tải lên không được hỗ trợ để chuyển đổi. |
| 429 | Quá nhiều yêu cầu | Bạn đã vượt quá giới hạn tốc độ (60 yêu cầu mỗi phút). Đợi và thử lại. |
| 500 | Lỗi máy chủ nội bộ | Đã xảy ra lỗi không mong muốn. Nếu tình trạng này vẫn tiếp diễn, hãy liên hệ với convert2webp@deployvision.com. |