Files
SnapOtter/apps/docs/vi/tools/image/red-eye-removal.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.7 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Phát hiện và sửa mắt đỏ do đèn flash máy ảnh gây ra, do AI hỗ trợ. 647c6ff1ef7c human d839f0139ddd

Red Eye Removal

Phát hiện và sửa mắt đỏ do đèn flash máy ảnh gây ra, do AI hỗ trợ.

API Endpoint

POST /api/v1/tools/image/red-eye-removal

Processing: Bất đồng bộ (trả về 202, thăm dò /api/v1/jobs/{jobId}/progress để lấy trạng thái qua SSE)

Model bundle: face-detection (200-300 MB)

Parameters

Parameter Type Required Default Description
file file Yes - Tệp ảnh (multipart)
sensitivity number No 50 Độ nhạy phát hiện mắt đỏ (0-100). Giá trị càng cao càng phát hiện mắt đỏ tinh tế hơn
strength number No 70 Cường độ sửa (0-100). Mức độ mạnh khi trung hòa màu đỏ
format string No - Định dạng đầu ra (ghi đè tùy chọn)
quality number No 90 Chất lượng đầu ra (1-100)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/image/red-eye-removal \
  -F "file=@flash-photo.jpg" \
  -F 'settings={"sensitivity":60,"strength":80}'

Response

Initial Response (202 Accepted)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Progress (SSE at /api/v1/jobs/{jobId}/progress)

event: progress
data: {"phase":"processing","stage":"Detecting red eyes...","percent":40}

Final Result (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/flash-photo_redeye_fixed.png",
    "originalSize": 280000,
    "processedSize": 290000,
    "facesDetected": 2,
    "eyesCorrected": 4
  }
}

Notes

  • Yêu cầu cài đặt model bundle face-detection (200-300 MB).
  • Trước tiên phát hiện khuôn mặt, sau đó xác định các vùng mắt trong mỗi khuôn mặt, và cuối cùng nhận dạng và sửa các pixel mắt đỏ.
  • Số lượng facesDetected cho biết đã tìm thấy bao nhiêu khuôn mặt; eyesCorrected là tổng số mắt riêng lẻ đã được sửa mắt đỏ.
  • Đầu ra luôn là PNG để bảo toàn chất lượng tối đa.
  • Hỗ trợ các định dạng đầu vào HEIC/HEIF, RAW, TGA, PSD, EXR và HDR thông qua giải mã tự động.