Chuyển đến nội dung

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/v1

Xá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ạnKích thước tệp tối đaTệp hàng loạt tối đa
60 yêu cầu/phút10 MB mỗi tệp20 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ênKiểuYêu cầuSự miêu tả
fileFileYêu cầuTệp hình ảnh cần chuyển đổi. Chấp nhận PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO và WebP.
output_formatstringKhô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)
qualityintegerKhông bắt buộcChất lượng đầu ra từ 1 (thấp nhất) đến 100 (cao nhất).(mặc định: 80)
widthintegerKhông bắt buộcChiều rộng đầu ra tối đa tính bằng pixel. Tỷ lệ khung hình được giữ nguyên.
heightintegerKhông bắt buộcChiều cao đầu ra tối đa tính bằng pixel. Tỷ lệ khung hình được giữ nguyên.
strip_metadatabooleanKhông bắt buộcLoại bỏ siêu dữ liệu EXIF/IPTC/XMP khỏi đầu ra.(mặc định: true)

Phản hồi

200
Hình ảnh nhị phân được chuyển đổiimage/webp
400
Yêu cầu không hợp lệ (thiếu tệp, định dạng không được hỗ trợ, v.v.)application/json
413
Tệp quá lớnapplication/json
429
Đã vượt quá giới hạn tỷ lệapplication/json
500
Lỗi máy chủ nội bộapplication/json

Ví dụ mã

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

Thử ngay

Không có tập tin nào được chọn

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ênKiểuYêu cầuSự miêu tả
filesFile[]Yêu cầuMảng tập tin hình ảnh để chuyển đổi. Tối đa 20 tệp cho mỗi yêu cầu.
formatstringKhô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)
qualityintegerKhông bắt buộcChất lượng đầu ra từ 1 đến 100.(mặc định: 80)

Phản hồi

200
Kho lưu trữ ZIP chứa tất cả hình ảnh được chuyển đổiapplication/zip
400
Yêu cầu không hợp lệapplication/json
413
Tổng tải trọng quá lớnapplication/json
429
Đã vượt quá giới hạn tỷ lệapplication/json

Ví dụ mã

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

Liệ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

200
Đối tượng JSON liệt kê các định dạng đầu vào và đầu ra được hỗ trợapplication/json

Ví dụ mã

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

Phản hồi mẫu

response.json
{
  "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

200
Trạng thái và phiên bản dịch vụapplication/json

Ví dụ mã

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

Phản hồi mẫu

response.json
{
  "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-response.json
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}
Mã sốTênSự miêu tả
400Yêu cầu xấuYê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.
413Tải trọng quá lớnTệp đã tải lên vượt quá giới hạn 10 MB.
415Loạ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.
429Quá nhiều yêu cầuBạn đã vượt quá giới hạn tốc độ (60 yêu cầu mỗi phút). Đợi và thử lại.
500Lỗ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.