Vignette

Thêm hiệu ứng vignette làm tối hoặc nhuộm màu các cạnh của ảnh. Hỗ trợ cường độ, màu sắc, bán kính, độ mềm, độ tròn, và vị trí tâm có thể điều chỉnh.

API Endpoint

POST /api/v1/tools/image/vignette

Chấp nhận dữ liệu form multipart với một tệp ảnh và một trường JSON settings.

Tham số

Tham số	Kiểu	Bắt buộc	Mặc định	Mô tả
strength	number	Không	0.5	Độ mờ đục vignette (0.1-1)
color	string	Không	"#000000"	Màu vignette dạng hex
radius	integer	Không	70	Bán kính ngoài tính theo phần trăm nửa đường chéo (0-100)
softness	integer	Không	50	Độ mềm của phần feather (0-100); giá trị cao hơn tạo ra sự mờ dần từ tốn hơn
roundness	integer	Không	100	Hình dạng: 100 = hình tròn, 0 = hình elip khớp với tỷ lệ khung hình ảnh
centerX	integer	Không	50	Vị trí tâm ngang tính theo phần trăm (0-100)
centerY	integer	Không	50	Vị trí tâm dọc tính theo phần trăm (0-100)

Ví dụ Request

curl -X POST http://localhost:1349/api/v1/tools/image/vignette \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"strength": 0.7, "radius": 60, "softness": 70}'

Ví dụ Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 2410000
}

Ghi chú

• radius nhỏ hơn làm tối nhiều hơn phần ảnh; bán kính lớn hơn giới hạn vignette ở các cạnh ngoài cùng.
• Dùng color không phải màu đen (ví dụ tông trắng hoặc sepia) cho các hiệu ứng vignette sáng tạo.
• Điều chỉnh centerX và centerY cho phép bạn đặt vùng rõ nét lệch tâm, hữu ích để tập trung sự chú ý vào một chủ thể không ở giữa khung hình.
• Định dạng đầu ra khớp với định dạng đầu vào. Đầu vào HEIC, RAW, PSD, và SVG được tự động giải mã trước khi xử lý.