Thay đổi kích thước ảnh API

Thay đổi kích thước, cắt, xoay, lật và đổi định dạng ảnh PNG ↔ JPEG với thuật toán chất lượng cao, chỉnh chất lượng JPEG để giảm dung lượng.

POSThttps://apibox.io.vn/v1/image-resize

API resize ảnh xử lý ảnh PNG hoặc JPEG tải lên. Đặt width và / hoặc height (cạnh còn lại giữ tỷ lệ) và kiểu fit: inside (mặc định, vừa trong khung), cover (lấp đầy khung và cắt phần giữa, hợp với ảnh thumbnail), contain (vừa khung và thêm viền màu background) hoặc fill (kéo giãn). crop=x,y,width,height cắt một vùng trước, rotate (90, 180, 270) và flip (horizontal, vertical) để xoay, lật, no_enlarge=true để không phóng to.

Khi thu nhỏ, API lấy trung bình theo diện tích nên chi tiết vẫn sắc nét, không răng cưa; khi phóng to dùng nội suy song tuyến. Xuất format=jpeg với quality (1–100, mặc định 82) để giảm dung lượng; vùng trong suốt được phủ màu nền. Header cho biết kích thước mới và số byte đầu vào / đầu ra.

Nhận ảnh tối đa 25 megapixel và trong giới hạn dung lượng tệp của gói; mọi thứ xử lý trong bộ nhớ, không lưu lại.

Tham số

TênVị tríKiểuBắt buộcMặc định
filebodyfilecóẢnh PNG hoặc JPEG (multipart, body thô hoặc file_base64).
widthquery|bodynumberkhôngChiều rộng mới (px).
heightquery|bodynumberkhôngChiều cao mới (px).
fitquery|bodystringkhônginsideinside, cover, contain, fill.
cropquery|bodystringkhôngx,y,width,height cắt trước khi resize.
rotatequery|bodynumberkhông90, 180 hoặc 270.
flipquery|bodystringkhônghorizontal hoặc vertical.
formatquery|bodystringkhôngpng hoặc jpeg (mặc định: như ảnh gốc).
qualityquery|bodynumberkhông82Chất lượng JPEG 1–100.
backgroundquery|bodystringkhôngffffffMàu viền / màu phủ nền.

Ví dụ

curl -X POST "https://apibox.io.vn/v1/image-resize?width=400&height=400&fit=cover&format=jpeg" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "0=@./my-file" \
  -o output

Kết quả trả về

binary image/jpeg

Ứng dụng

  • Tạo thumbnail, avatar từ ảnh người dùng tải lên
  • Thu nhỏ ảnh chụp trước khi lưu trữ
  • Đổi ảnh chụp màn hình PNG sang JPEG nhẹ hơn
  • Ảnh vuông cho sàn thương mại điện tử, mạng xã hội

Hỏi đáp

Có tự xoay theo EXIF không?

Chưa tự động; dùng rotate= khi ảnh bị nằm ngang (image-metadata cho biết hướng EXIF).

Có hỗ trợ WebP không?

Chưa: chỉ PNG và JPEG.

Giới hạn kích thước là bao nhiêu?

25 megapixel và dung lượng tệp theo gói (5–50 MB).

API liên quan

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →